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DATABASE 





Usa subito Microsoft SQL Server 2005 
e Oracle 10g, i DB di terza 
generazione 

STRUMENTI per creare e gestire 
gli archivi in modo immediato 

CODICE per accedere 

con Visual Basic.NET e Java 

CONSIGLI per migrare 
da Access a MS SQL 

NOVITÀ da conoscere [ORACLE }0 J 

per migliorare il tuo software! lEXPRESSEDITIOH 



SCAMBIO FILE SU CELLULARI 



in 





TELETRASPORTO'' CON 

BLUETOOTH 

Tutto sul protocollo che gestisce il trasferimento 
dati tra dispositivi mobili 



CASI DI STUDIO: JAVA 



APPLICAZIONI PRONTE 
DA ESTENDERE 

Realizza un software che interpreta moduli 
e aggiunge funzioni sviluppate dall'utente 




SSaSSib 



PROBLEMI 

CON SQL ADDIO! 

Trasforma i tuoi dati in classi 
ed oggetti. Con NHibernate 
fai tutto con un solo 
strumento 



GRAFICA 
SENZA SEGRETI 

Dalle trasparenze alla gestione 
dei ritagli e dei font, un 
esempio concreto! 



INTERNET 



PHP MAILBOT 

Progetta un'applicazione 
Web per la gestione di una 
Newsletter 



.NET ADVANCED 



MICROSOFT 
MESSAGE QUEUE 

La guida all'uso del sistema 
che gestisce lo scambio dei 
messaggi tra applicazioni 



SPECIALE 



SERVICES 



VISUAL BASIC 6.0 



CALCIO & SCOMMESSE SCRIVI IN VB LEGGI IN WORD 

Ecco come funzionano gli algoritimi più 
efficaci per la riduzione dei sistemi 



Generiamo dinamicamente documenti RTF 
dai dati di una nostra applicazione 



ALGORITMI 



ORDINAMENTO 



J RADIX SORT, 
il metodo utilizzato dalle applicazioni Real Time 
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Guerra sui Database 



Che l'unico reale elemento di novità nel campo 
dei linguaggi fosse stato portato da Microsoft 
con il suo framework 2.0 sembra essere un dato 
acquisito. Allo stesso modo si lavora già su 
Windows Vista e di conseguenza su tutti gli argo- 
menti correlati al nuovo sistema nel campo dello 
sviluppo. Pertanto sembrerebbe che se il mondo 
degli sviluppatori dovesse interagire unicamente 
con i linguaggi di sviluppo, ci sarebbe ben poco 
fermento, almeno riguardo alle applicazioni stan- 
dalone. Viceversa, in questo periodo la competi- 
zione fra le varie software house sembra essersi 
spostata sui database. Ha cominciao MySQL che 
con la sua versione 5.0 ha introdotto novità tali 
che sembrano preannunciare la volon tà di entra- 
re nel segmento aziendale medio alto, ha prose- 
guito PostgreSQL che con l'introduzione di speci- 
fici strumenti di installazione in ambiente 
Windows sembra voler uscire dall'universo Unix 
dove è già leader. E infine sono scesi in campoi 
Big. Prima è arrivata Microsoft con il suo MS SQL 
Server 2005 Express Edition che sembra essere la 
porta di ingresso proposta ad aziende medio /pic- 



cole per approdare a soluzioni più strutturate, 
ovvero MS SQL Server Standard Edition e a ruota 
udite, udite si è presentata addirittura Oracle con 
una sua versione express del server lOg, altrettan- 
to gratuita di quella di Microsoft e con le stesse 
identiche limitazioni. È facile dedurre che nessu- 
no vuole stare fuori dal mercato dei database. È li 
che si è spostata la competizione. E su questo seg- 
mento che i grandi giocano una partita importan- 
te. Ovviamente tutto va a vantaggio di noi pro- 
grammatori, che possiamo adesso provare stru- 
menti innovativi a costo completamente gratuito 
e persino utilizzarli in modo del tutto gratuito e 
legale nei propri software con, ovviamente le 
dovute limitazioni. Resta comunque il fatto che 
siano tutti ottimi strumenti. Noi di ioProgrammo 
ve li presentiamo tutti, lasciando a voi poi decide- 
re quale sia il migliore per le vostre esigenze. 
L'eccezionale disponibilità di strumenti ciascuno 
con le proprie pecularietà ben si adatta alle 
necessità di personalizzazione che il mercato 
della programmazione richiede. 

Fabio Farnesi ffarnesi@edmaster. it 



□ CD □ WEB 

nome_file.zip 



^ 



All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http : / / cdrom.ioprogrammo.it. 



DATABASE 




Usa subito Microsoft SQL Server 2005 
e Oracle lOg, i DB gratuiti 
di terza generazione 

• Scaricali dalla rete e installali 
sul tuo PC senza costi di licenza 

• Utilizzali con Visual Basic.NET 
e Java 

• Migra da Access a MS SQL 
utilizzando il formato mdf 
invece del vecchio MDB 

• Scopri le espressioni regolari, 
i lob e le funzionalità avanzate 
di Oracle 



L'Universo TV. 
Ito n.5670 del 16/12/2005 www.itpartal.it 
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ORACLE 10 9 XE: MUOVO E GRATIS 

Oracle introduce una nuova versione del suo database con nuove 

funzionalità per velocizzare e ottimizzare lo sviluppo. 

E rende il tutto gratis, per ogni applicazione pag.24 



IOPROGRAMMO WEB 



PHP MailBot pag. 32 

Impareremo come creare un'interfaccia web 
per la gestione di una newsletter. Lo scopo 
sarà inserire e rimuovere gli utenti oltre che 
spedire la newsletter e conservare tutto in 
un database 



MOBILE 



Te le trasporto con 
BlueTooth pag 36 

Scambio file sui cellulari, 
tutto sul protocollo che 
gestisce i trasferimenti fra 
dispositivi mobili 



GRAFICA 



Immagini Annotate 

con Java pag. 72 

L'annotazione di un'immagine consiste 
nell'evidenziare riquadri della stessa a cui 
associare una breve descrizione. Questo 
articolo illustra come creare un componente 
Swing dotato di questa funzionalità 



SPECIAL CONTENT 



Anteprima sul nuovo 

Java 6 SE pag. 62 

Migliorata l'integrazione con il desktop del 
sistema operativo di riferimento: è possibile 
implementare il comportamneto della barra 
di stato e gestire l'aggiunta di icone con 
menu popup personalizzabili 



VISUAL BASIC 



VB& OffÌCe pag 64 

Generiamo dinamicamente 
documenti RTF dai dati di una 
nostra applicazione 



SISTEMA 



Web services con Visual 
Basic.NET pag. 72 

Oggi è possibile utilizzare i web services 



per sviluppare applicazioni distribuite in 
maniera semplice, sicura e veloce. 
VB.NET contiene strumenti efficaci per 
questa tecnologia, vediamo quali. 

Microsoft Message Queue 
Programming pag. 78 

Abbiamo visto nel numero precedente 
una overview architetturale del 
prodotto. In questo articolo vedremo 
MSMQ all'opera utilizzando le varie 
opzioni di delivery 



SISTEMA 



Java Scripting 
HowTo 

Sviluppiamo software 
"estendibile" dagli utenti 
tramite un linguaggio interno 
facile e immediato 



pag. 88 



DATABASE 



Primi passi 

con IMHibernate pag. 88 

Il popolarissimo framework di 
persistenza dei dati che da solo riesce a 
cambiare la vita di noi sviluppatori 



ADVANCED EDITION 



96 



A tutta scommessa pag 

Appassionati di totocalcio? Ecco un 
algoritmo possibile per ottenere sistemi 



RUBRICHE 



Gli allegati di ioProgrammo 

// software in allegato alla rivista 



pag. 6 



Il libro di ioProgrammo pag. 7 

// contenuto del libro in allegato alla rivista 

News pag. 12 

Le più importanti novità del mondo 
della programmazione 

ioProgrammo by Example pag. 52 

9 problemi risolti con gli esempi di codice rapido 
da copiare e incollare per tutti i linguaggi 

Software pag. 106 

/ contenuti del CD allegato ad ioProgrammo. 
Corredati spesso di tutorial e guida all'uso 



sufficientemente affidabili senza 
spendere una fortuna 



SOLUZIONI 



Radix sort pag. 109 

Radix sort, Bucket sort e postman's sort 
appartengono alla famiglia dei 
distribution sort. Si tratta di metodi 
dalle sorprendenti performance che 
però richiedono un'attenta analisi dei 
dati sottoposti a ordinamento. 
Cerchiamo di capire come funzionano e 
a cosa bisogna stare attenti 



ioProgrammo by EXAMPLE 



.NET& PHP 

Come posso realizzare un WebService?...49 
Come posso controllare lo stato 

del tasto Caps Lock? 52 

Come posso verificare che 

un Web Service funzioni? 52 

Come si installa un Web Service in MS? ..54 

Ricavare informazioni sui tipi 56 

Come posso utilizzare un Web Services? .56 
Che cosa vuol dire WSDL 58 

MYSQL 

Quali sono i comandi base di MySQL 

da linea di comando? 58 

Java 

Come elencare i font disponibili? 59 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella 
sua interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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Le versioni di ioProgrammo 
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APPLICAZIONI PRONTE 

DA ESTENDERE 

Realizza un software die intr^preta moduli 
e aggiunge funzioni intoppato -esali utente 

CALCIO & SCOMMESSE SCRIVI IN VB LEGGI IN 



rivista + 2 cd-rom in edicola 



Prodotti del mese 



Oracle 109 
Express Edition 

Per la prima volta In versione 
gratuita, arriva II DB per le 
aziende 

Oracle si è sempre caratterizzata perla 
sua volontà di servire il mercato B2B, 
ed è ancora così. Per anni il suo data- 
base è stato il leader nel segmento 
aziendale. Fino a ieri nessuna o quasi 
nessuna applicazione destinata alle 
aziende medio piccole ha potuto usu- 
fruire della potenza di questo DB so- 
prattutto in relazione agli enormi co- 
sti da sostenere. Oggi tutto è cambia- 
to e Oracle per la prima volta presenta 
una versione Express gratuita del pro- 
prio strumento principe. Si tratta di una 
novità non da poco. Questa versione è 
identica in tutto e per tutto alla ver- 
sione standard eccetto che per il fatto 
di poter servire un solo processore, ge- 
stire fino a un massimo di 4GB di dati, 
e utilizzare un solo GB di RAM. I lin- 
guaggi con cui può essere integrato 
tramite appositi connector sono i più 
svariati. 

[pag.106] 



VS.PHP For 
Visual Studio 2005 

L'Addin per usare Visual Studio come 
editor per PHP 

Si tratta di una vera e propria novità. 
Utilizzare uno degli editor più evo- 
luti al mondo per programmare per il 
web utilizzando il linguaggio PHP. Al- 
cuni potrebbero pensare che si trat- 
ti in fondo del solito editor con sin- 
tassi colorata, e invece tutte le fun- 
zioni avanzata ci sono tutte, dalla 
syntax highlighting alla code com- 
plexion, più alcune funzionalità de- 
cisamente avanzate che non si tro- 
vano tipicamente nemmeno in edi- 
tor nativi per PHP come ad esempio il 
supporto a smarty il template desi- 
gner di PHP utilissimo per separare 
la logica di programmazione da quel- 
la di design. Si tratta insomma di uno 
strumento di eccezionale rilevanza 
che può diventare realmente signifi- 
cativo per coloro che fino ad ora non 
hanno trovato un IDE sufficiente- 
mente evoluto per lo sviluppo delle 
proprie Web Application. 

[pag.107] 



AXIS1.3 

Il framework per lo sviluppo di 
Web Service in Java 

Che i Web Service rappresentino 
una risorsa enorme per la pro- 
grammazione è ormai noto, in que- 
sto stesso numero di ioProgrammo 
diamo enorme spazio all'argomen- 
to proprio con una serie di esempi 
pratici per lo sviluppo. Mancano 
dai nostri esempi proprio quelli re- 
lativi a Java di cui ci occuperemo 
nei numeri successivi della rivista. 
Axis è comunque il tool fondamen- 
tale per poter sviluppare WS con il 
linguaggio di SUN. Il suo utilizzo è 
abbastanza semplice, e supporta 
tutte le caratteristiche avanzate 
come ad esempio la generazione 
dinamica dei WSDL oppure il de- 
bugging delle trasmissioni SOAP 
Lavora in congiunzione stretta con 
Tomcat e il suo deployment si ridu- 
ce a copiare i file nella directory 
corretta.. Uno strumento indispen- 
sabile di cui non mancheremo di 
parlare ulteriormente. 

[pag.106] 



NHIBERNATE 1.0.2 

Il tool di persistenza dei dati 
per eccellenza 

Ce ne parla Giancarlo Sudano in 
questo stesso numero di ioPro- 
grammo. Nhibernate è il porting 
del famoso Hibernate per Java su 
piattaforma .NET. 
La sua utilità è estrema, consente 
infatti di trasformare le normali 
Query SQL in oggetti e classi di 
modo che siano omogenei con il 
codice a cui uno sviluppatore è 
abituato. Oltre a questo Nhiber- 
nate è un tool di persistenza che 
consente di "salvare" lo stato dei 
dati su uno Storage, anche questo 
in modo indipendente dal lin- 
guaggio SQL. A fare da ponte fra 
l'architettura del database e il lin- 
guaggio ad oggetti sarà un sem- 
plice file XML. La coomodità di 
uno strumento del genere é inne- 
gabile, tanto che la maggior parte 
dei linguaggi si sta orientato a 
dotarsi internamente di questo 
genere di tecnologia. 

[pag.107] 
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DATABASE 



M subito Microsoft SQL Server 2005 
e Oracle lOg , i DB di terza 
generazione 

STRUMÉNTI per creare e gesti™ 

tj\ì archivi in modo immediato 

CODICE per accedere 

con Visual Bsstc.NET e Java 

CONSIGLI per migrare 
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I contenuti del libro 



Imparare JAVA 



Quando qualche anno fa, quando Java ha fatto il 
suo ingresso sul mercato assomigliava a qualcosa 
di utile per inserire un miniprogramma all'interno 
di una pagina Web, era l'era delle Applet. A distanza di 
quasi 10 anni dal suo primo rilascio, il linguaggio si è 
evoluto in modo sostanziale, fino a diventare il punto di 
riferimento per le applicazioni aziendali come 
dell'OpenSource e persino uno dei linguaggi più didattici 
per il mondo universitario. Ivan Venuti ce ne illustra 
passo dopo passo le varie caratteristiche. Si parte 
dall'ABC dei costrutti elementari fino ad arrivare a 
trattare argomenti avanzati che coinvolgono l'uso dei 
package e l'ottimizzazione del software. Un manuale di 
riferimento pratico ed efficiente che non deve mancare 
all'utente esperto come a chi inizia. 



IL MANUALE RAPIDO 
PER PROGRAMMARE SOFTWARE 
PER WINDOWS E PER LINUX 
CON UN UNICO LINGUAGGIO 

■ I fondamenti della tecnologia 

■ La programmazione orientata agli oggetti 

■ I package e l'organizzazione delle classi 

■ Ottimizzazione del software 



http://www.ioprogrammo.it 
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I contenuti multimediali 



GLI ALLEGATI DI IOPROGRAMMO 



▼ Programmare in Team i videocorsi per programmare bene 



I 



C'era una volta il singolo 
programmatore, che da 
solo forte delle sue conoscenze 
riusciva a soddisfare le "poche 
esigenze" dei clienti. Nel corso 
degli anni la domanda è cam- 
biata. Le esigenze sono diven- 
tate del tutto diverse e sempre 
più complesse. Difficilmente 
un singolo programmatore 
sarebbe in grado di produrre 
un'applicazione completa in 
grado di servire un'azienda 
medio grande. Per questo è 
nata la programmazione in 
team che consente di affidare 
singoli moduli, piccole entità 
ad un singolo per poi raggrup- 
pare tutto sotto un unico cap- 
pello. Questo ovviamente ha 



introdotto nuovi problemi. Chi 
si occuperà di progettare l'in- 
tera applicazione? di quali 
strumenti avrà bisogno? chi si 
occuperà di sincronizzare le 
varie revisioni? la risposta di 
Microsoft a tutto questo e a 
molto altro è contenuta in 
Visual Studio Team System, 
ovvero lo strumento pensato 
da MS per consentire a piccoli 
e grandi gruppi di lavoro di 
lavorare insieme in modo 
omogeneo. Si tratta di uno sru- 
mento molto complesso che 
tuttavia implicitamente con- 
tiene tutte le soluzioni per ren- 
dere immediatemente produt- 
tiva qualunque software 
house. 



4.WEBCAST 

TUFFICIALI MICROSOFT 




| GRATIS NEL CD "I CORSI DI FORMAZIONE" 
DA SEGUIRE COMODAMENTE SUL PC msdn 

VISUAL STUDIO team system 

• Introduzione e logica 

• Tecniche per l'application Modeling 

• Gestione del codice sorgente 

• Cosa è e come funziona il project 
Management 



INFORMAZIONI SU MSDN WEBCAST 

http://www.microsoft.it/msdn/webcast_msdn 
http://forum.ioprogrammo.it 



FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratui- 
ti online e interattivi che approfondiscono le principali 
tematiche relative allo sviluppo di applicazioni su tecnolo- 
gia Microsoft. Questa serie di "corsi" sono noti con il nome 
di Webcast MSDN 

Come è composto tipicamente 
un Webcast? 

Normalmente vengono illustrate una serie di Slide com- 
mentate da un relatore. A supporto di queste presentazio- 
ni vengono inserite delle Demo in presa diretta che 
mostrano dal vivo come usare gli strumenti oggetto del 
Webcast 

Come mai trovo riferimenti a chat 
o a strumenti che non ho disponibili 
nei WebCast allegati alla rivista? 

La natura dei WebCast è quella di essere seguiti OnLine in 
tempo reale. Durante queste presentazioni in diretta ven- 
gono utilizzati strumenti molto simili a quelli della forma- 
zione a distanza. In questa ottica è possibile porre doman- 
de in presa diretta al relatore oppure partecipare a son- 
daggi etc. I WebCast riprodotti nel CD di ioProgrammo, pur 
non perdendo nessun contenuto informativo, per la natura 



asincrona del supporto non possono godere dell'interazio- 
ne diretta con il relatore. 

Come mai trovo i WebCast 
su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai 
programmatori italiani. Abbiamo pensato che poter usu- 
fruire dei WebCast MSDN direttamente da CD rappresen- 
tasse un ottimo modo di formarsi comodamente a casa e 
nei tempi desiderati. Lo scopo tanto di ioProgrammo, 
quanto di Microsoft è infatti quello di supportare la comu- 
nità dei programmatori italiani con tutti gli strumenti pos- 
sibili. 

Su ioProgrammo troverò tutti 
WebCast di Microsoft? 

Ne troverai sicuramente una buona parte, tuttavia per loro 
natura i webcast di Microsoft vengono diffusi anche OnLine e 
possono essere seguiti previa iscrizione. L'indirizzo per saperne 
di più è: http://www.microsoft.it/msdn/webcast/msdn segnalo 
nei tuoi bookmark. Non puoi mancare. 

L'iniziativa sarà ripetuta sui prossimi 
numeri? 

Sicuramente si. 
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ENNESIMO EXPLOIT 
PER EXPLORER 

■* "on c'è pace per il browser di Mi- 
crosoft. Questa volta è una falla 
nel metodo CreateTextRangeO pre- 
sente sia in IE6 che, udite udite, 
nella beta 2 di IE7. 
L'exploit proviene direttamente dal 
notissimo gruppo di hacker unIOck 
.net, tuttavia sarebbe stato modifi- 
cato da moltissime altre mani tanto 
che in molti pensano che a breve si 
trasformerà in un nuovo potente 
virus. Al momento in cui scriviamo 
Microsoft non ha rilasciato alcuna 
patch e consiglia di disattivare Java- 
Script, tuttavia ha già dichiarato che 
il problema sarà risolto con la pub- 
blicazione dei bollettini del mese di 
Aprile 

ANCORA 
RIMANDATO 
IL LANCIO 
DI OFFICE 2007 

Il rilascio della nuova versione della 
I suite per l'ufficio di Microsoft do- 
vrà essere allineato al rilascio di 
Windows Vista. Questa è la decisio- 
ne del gigante di Redmond su uno 
dei suoi software di punta. In parti- 
colare poiché Windows Vista è at- 
teso per l'inizio del 2007 allo stesso 
modo Office 2007 vedrà la luce nei 
primi mesi del nuovo anno. Non si 
tratta di una novità di poco conto se 
si tiene conto che il mercato dei PC 
attende l'arrivo del nuovo sistema 
come una sorta di ancora di salvezza 
che possa in una qualche maniera 
incentivare all'acquisto di nuovo 
hardware. 

D'altra parte da anni questo mercato 
sopravvive con alterna fortuna, ma 
senza mai raggiungere i picchi di 
gloria che aveva vissuto dai tempi 
del 386 fino ai primi pentium. Inoltre 
Microsoft sta conducendo una cam- 
pagna molto intensa su Windows 
Vista e sui prodotti ad esso correlati. 
È più che giusto che desideri rilascia- 
re il sistema senza farsi stressare dai 
tempi di uscita, quanto piuttosto 
osservando i dettami della qualità. 
Un nuovo sistema colmo di bug non 
aiuterebbe nessuno. 



PRIME INDISCREZIONI 
SU PHP 6 



L'arrivo di PHP 5 era stato salu- 
tato come un'eccezionale 
novità. Ed in effetti lo è stato! Un 
modello ad oggetti completa- 
mente rinnovato metteva in 
mano al programmatore uno 
strumento potente e ben curato 
per compiere il necessario salto di 
qualità dalla classica programma- 
zione procedurale ad una più 
moderna e funzionale program- 
mazione ad oggetti. E tuttavia 
PHP è forse l'unico linguaggio di 
successo al mondo dove la pro- 
grammazione ad oggetti ha otte- 
nuto scarso o poco successo. Di 
fatto la maggior parte dei pro- 
grammatori sono rimasti attacca- 
ti alla buona vecchia programma- 
zione procedurale del PHP 4. 
Pochissime fra le web application 
più note sono state convertite 
alla nuova versione. In questo 
scenario che vede ancora PHP 4 
fare da padrone e PHP 5 stentare 
a decollare si inseriscono le prime 



indiscrezioni sul futuro PHP 6. Le 
novità riguarderebbero un 
migliorato supporto ad Unicode, 
che consentirebbe di sviluppare 
applicazioni non curandosi della 
tipologia di carattere da usare ma 
lasciando a PHP il compito di sce- 
gliere il formato di codifica per 
l'input e per l'output. Alcune 
modifiche "minori" riguardereb- 
bero determinate direttive del- 
l'interprete che fino ad ora ave- 
vano creato più problemi che 
benefici. In particolare scompari- 
rebbero le tanto contestate regi- 
ster_ globals, magic_quotes e 
safe_mode. Una novità apparen- 
temente poco entusiasmante ri- 
guarderebbe l'uso di APC: "Alter- 
native PHP Cache". Fino ad oggi 
in pochi avevano sfruttato questa 
estensione di PHP. APC consente 
di "compilare" degli script PHP e 
mantenerli in una cache di modo 
da ottimizzare le performance di 
un sito che ne fa uso, nella nuova 



GERMANIA: RISCHIA 
DUE ANNI CHI SCARICA! 



E il frutto della legge appena ap- 
provata dal parlamento federale 
tedesco. Nessuna indulgenza per i pi- 
rati! Chi scarica illegalmente conte- 
nuti protetti da copyright è in tutto e 
per tutto assimilabile a chi compie un 
furto, per tale motivo la condanna pre- 
vista è di 2 anni di reclusione. Si trat- 
ta di una delle leggi fino ad ora più du- 
re in Europa. La Germania sceglie di 
adottare il pugno di ferro contro la pi- 
rateria che, secondo i politici e gli eco- 
nomisti tedeschi starebbe gettando 
in ginocchio il mercato della musica e 
della cinematografia. Naturalmente 
sono state dure le reazioni delle or- 
ganizzazioni dei consumatori che fan- 
no notare come il fenomeno abbia 
raggiunto proporzioni tali da merita- 
re un'attenzione diversa. Stando così 



le cose, viceversa, una famiglia tede- 
sca potrebbe vedersi recapitare un 
mandato di cattura a causa delle scor- 
ribande informatiche di un figlio se- 
dicenne. Probabilmente si tratta di un 
metodo per debellare un fenomeno 
che realmente mette a rischio un mer- 
cato che è una fonte importante per l'e- 
conomia tedesca ed europea in ge- 
nere. E' anche vero che mentre la tec- 
nologia ha fatto passi da gigante nel 
campo delle comunicazioni, nessun 
tentativo da parte delle major è stato 
fatto per adeguarsi ai nuovi tempi. E' 
la solita storia che ormai ci portiamo 
avanti da qualche anno. Si adegue- 
ranno le major alle nuove tecnologie, 
oppure le carceri tedesche saranno 
sovraffolate di sedicenni amanti del- 
la buona musica? 
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565 MILIONI PER 
LA TECNOLOGIA 



versione di PHP questa estensione 
sarà inclusa nel core del linguaggio. 
Una novità decisamente più eclatante 
riguarderebbe il già tanto discusso 
modello ad oggetti, di fatto verrebbe 
introdotto il tanto caro concetto di 
"namespace" , che consente di rag- 
gruppare sotto un unico "ombrello", 
variabili, oggetti e classi. Infine gran- 
di movimenti coinvolgerebbero le 
estensioni tipicamente disponibili per 
il linguaggio. Alcune storiche esten- 
sioni come "ereg" sparirebbero a fa- 
vore di altre più moderne come 
"PCRE". Una lista piuttosto completa 
di cosa accadrà a PHP con la nuova 
versione è disponibile all'indirizzo: 
http://php.net/~derick/meeting-notes 
.html. 



E quanto stanziato dal ministero per 
l'innovazione tecnologica per la 
creazione di 36 distretti digitali, pic- 
cole cittadelle che svolgeranno fun- 
zione di polo d'aggregazione per lo svi- 
luppo dell'high tech in Italia. In par- 
ticolare saranno cinque le priorità su cui 
il governo intende concentrare i propri 
sforzi per abbattere la barriera digita- 
le che divide il sud dal nord del paese. 
"Sviluppo di azioni per la promozione 
di una cultura dell'innovazione digi- 
tale", ovvero dall'e-learning alla for- 
mazione finalizzata alla riqualifica- 
zione delle risorse umane - "sviluppo 
delle infrastrutture immateriali", per 
agevolare la domanda di connetività, le 
reti wireless e la produzione di appli- 
cazioni innovative nel campo della pro- 
duzione logistica e del marketing - "ap- 
plicazione del codice dell'ammini- 
strazione digitale", ovvero si intende 
dare effettiva concretezza alle norme già 
vigenti sull'informatizzazione della 
pubblica amministrazione e sui rap- 
porti con il cittadino, la dove la RA. non 
sempre è stata capace di adottare le 
nuove tecnologie come una risorsa 



concreta per fornire servizi efficienti - 
"Sviluppo di piattaforme tecnologiche 
a supporto dei processi produttivi per 
nuovi distretti" , per sostenere aziende 
o consorzi che agiscano come "consu- 
lenti d'impresa" dei distretti tecnologici 
- infine "Finanza per l'innovazione", 
ovvero un fondo per la creazione di im- 
prese innovative. 

Si tratta di un finanziamento impor- 
tante a cui il ministro Stanca affida la 
creazione di un ecosistema digitale 
fatto da piccole, grandi imprese e 
università che tutte insieme mettono 
in moto un meccanismo integrato 
per il rilancio del mercato informati- 
co in Italia. 




FESTA DEGLI SCONOSCIUTI 
AL JOLT AWARD 2006 



Il Jolt Award è uno dei riconosci- 
menti più prestigiosi che ogni an- 
no vengono riconosciuti ai programmi 
che si sono distinti nell'ingegneria 
del software. La manifestazione è 
talmente prestigiosa da potersi per- 
mettere di non essere minimamen- 
te influenzata dai grandi nomi che 
tipicamente affollano il panorama 
informatico. Così quest'anno a farla 
da padrone nel campo dei Web De- 
velopmentTooIs è addirittura lo sco- 
nosciutissimo ai più Rails 1.0, nato 
dall'ancora meno noto Ruby. Men- 
tre nel campo dei Design Tools si af- 
ferma l'ignoto Lattix. Certo non man- 



cano i nomi noti, a vincere il premio 
nella categoria Database è il nuovo 
nato Microsoft Sql Server 2005 che 
si lascia dietro le spalle il Berkeley 
DB 4.4, solo al quarto posto MySQL 
5.0. La situazione si ribalta nel premio 
riservato all'enterprise project ma- 
nagement dove ad avere la meglio 
è stato Welcom Risk 2.6 seguito da 
Corticon Business Roles Management 
e Jboss, si piazza solo al quarto po- 
sto Microsoft Visual Studio Team Sy- 
stem 2005 che invece domina nel 
campo degli ambienti di sviluppo la- 
sciandosi dietro le spalle Eclipse 3.1, 
intelliJ Idea 5.0 e Komodo 3.5. 



Nel campo dei framework prevale 
ancora Microsoft con il suo .NET 2.0 
a seguire Dundas Chart for .NET, 
QT 4.0 e solo quarto lo Spring Fra- 
mework di Java. Vincitore su tutti 
con grande merito e prestigio Vi- 
sual Studio Professional Edition 
che vince nella categoria "Hall of 
Fame" senza nessun rivale, decisa- 
mente un successo. È importante 
notare come nel campo dell'alta 
tecnologia le sfide siano poco in- 
fluenzate dalle politiche di marke- 
ting, mentre invece a vincere è 
sempre la buona progettazione e 
l'utilità per i consumatori. 
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550.000 
DOMINI FATTI 
FUORI DA Ul\l 
DDOS 

In Italia sicuramente non è uno 
dei register più famosi ma lo è 
sicuramente nel mondo, si tratta 
di Joker.com. L'azienda sarebbe 
stata fatta oggetto di un violento 
attacco di DdoS tale che circa 
550.000 domini sarebbero stati 
messi fuori gioco. Il DdoS è pur- 
troppo una pratica difficile da 
intercettare, anche se non sono 
ancora note le modalità con cui 
sia stato possibile mettere in 
corto circuito un'azienda del cali- 
bro di Joker.com con un attacco 
di tipo DdoS. Al momento si 
pensa a tecniche di tipo ricorsivo 
aiDNS. 

LA CIMA CONTRO 
LA PIRATERIA 

Sarebbero 14 le fabbriche co- 
strette alla chiusura da un blitz 
compiuto dal governo e teso a 
combattere la pirateria. Le 
strutture in questione sarebbero 
state dotate di attrezzature tali da 
poter produrre quantitativi 
enormi di materiale contraffatto. 
Che la Cina nota per essere la 
patria dell'imitazione sia scesa in 
campo contro il fenomeno della 
duplicazione illegale è sintomo 
di quanto i nostri tempi stiano 
cambiando. Certo c'è differenza 
fra imitazione e duplicazione 
esatta, tuttavia certamente fino 
ad ora non erano mancati sul 
mercato i prodotti oggetto di 
contraffazione provenienti dai 
mercati asiatici. 



ARRIVA 



PHP INTEGRATED 



DEVELOPMENT ENVIRONMENT 



osi dopo avere a lungo frequenta- 
to gli ambienti periferici di Eclipse, 
il PHP IDE ha finalmente raggiunto la 
maturità necessaria per diventare a 
pieno titolo uno dei progetti di mag- 
giore rilievo all'interno della piattafor- 
ma di sviluppo. Al momento saranno 
tre gli aspetti su cui verrà focalizzata 
dagli sviluppatori. Prima di tutto il PHP 
IDE Core che conterrà le specifiche di 
linguaggio il code builder e il format- 
ter, oltre che tutta una serie di struttu- 
re necessarie a far ben funzionare l'in- 
tero ambiente. PHP IDE Ul è la sezione 
che si occuperà di definire l'interfaccia 



utente, infine il PHP IDE DEBUG ovve- 
ro la sezione dedicata all'implementa- 
zione di un debugger finalizzato a ren- 
dere la vita più semplice al program- 
matore. Così finalmente al classico 
ZEND Studio si affiancherà un IDE 
maturo e potente con alle spalle un 
team di sviluppatori capace di produr- 
re un IDE significativo per i program- 
matori PHP. Vedremo se il nascituro 
PHP IDE basato su Eclipse sarà all'al- 
tezza delle ben note straordinarie 
capacità di Zend oppure se annegherà 
anch'esso nella proverbiale fame di 
risorse tipica di Eclipse. 



MICROSOFT ABBRACCIA 
L'OPENDOCUMENT 



Nel nome dell'intero- 
perabilità era nata 
non molto tempo fa l'ODF 
Alliance che vedeva la par- 
tecipazione di oltre 35 
membri tra cui IBM, Sun, 
Novell, e Red Hat oltre che 
molti enti pubblici come 
l'American Library Asso- 
ciation. Scopo dell'ODF 
Alliance è stendere le linee 
guida per un formato 
OpenSource per la descri- 
zione dei documenti. La 
spinta alla formazione del 
consorzio era fornita dalla 



preoccupazione degli stati 
nel dover utilizzare un for- 
mato proprietario che li 
vincolasse all'adozione di 
un solo sistema operativo 
e comunque li soggiogasse 
agli intenti di un'azienda 
privata. 

Viceversa l'adozione di un 
formato OpenSource con- 
diviso da larga parte delle 
applicazioni garantirebbe 
la necessaria libertà di mo- 
vimento ai governi. 
Recentemente al gruppo 
delle aziende costituenti 



l'ODF si è aggiunta proprio 
Microsoft. L'ingresso del 
gigante di Redmond, se da 
un lato apre nuovi scenari, 
dall'altro nelle menti dei 
più maliziosi lascia insor- 
gere il sospetto che la soft- 
ware house di Bill Gates 
voglia in qualche modo 
rallentare l'adozione del 
nuovo formato a favore del 
proprio standard Open 
XML. 

Naturalmente Microsoft 
ha respinto totalmente le 
accuse. 



GLI UTENTI AIUTANO MICROSOFT 



Per la prima volta Microsoft utilizza 
un sistema largamente diffuso fra il 
software OpenSource ovvero quello di 
un sito pubblico destinato agli utenti che 
vogliano segnalare eventuali bachi 
riscontrati nell'uso dei programmi di MS. 
Il sito è raggiungibile all'indirizzo 
https://connect.microsoft.eom/default.a 
spx. Nella home page del progetto si 



legge "Collaborazione attiva allo svilup- 
po dei prodotti Microsoft" e ancora "Il 
sito consente di entrare in contatto con 
gli sviluppatori, i responsabili dei pro- 
dotti e gli altri membri dei team di svi- 
luppo allo scopo di contribuire al costan- 
te e decisivo miglioramento dei prodot- 
ti." Partecipare è semplice, basta accede- 
re con il proprio passport login , cliccare 



su "Invia Commento" e segnalare il bug 
scovato utilizzando uno dei programmi 
di MS. Il bug in questione se ritenuto 
valido sarà preso in gestione da uno svi- 
luppatore MS e la risposta sarà pubblica. 
Il sistema è molto simile a quello utiliz- 
zato dal noto bugzilla che tipicamente 
accompagna lo sviluppo di qualunque 
software OpenSource. 
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SQL SERVER 2005 
LEGGERO E FLESSIBILE 

IL DATABASE DI MICROSOFT SI RINNOVA. FRA LE GRANDI NOVITÀ: I DATI VENGONO 
CONSERVATI IN FILE MDF CON UNA LOGICA SIMILE A QUELLA DI ACCESS E UNA 
VERSIONE DEL TUTTO GRATUITA.. .COS'ALTRO ANCORA? 




n 
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— Basidi.NET 



Windows 2000/XP. 
Visual Basic.NET 2003. 
Sql Server 2005 



Ergisi g=g. 



Gli ultimi mesi del 2005 hanno visto 
nascere la famiglia di prodotti .NET 
2005 della Microsoft. In questo arti- 
colo ci occuperemo di introdurre SQL Server 
2005 e del suo utilizzo con Visual Basic .Net 
2003. La famiglia di prodotti SQL Server 2005 
prevede quattro nuove edizioni: 
Express, Workgroup, Standard ed Enterprise. 
La versione Express, è una versione free che 
permette di gestire database fino a 4GB, e 
con essa sono forniti, sempre gratis, un 
Management Tool e un Report Tool. 
Le altre tre versioni a pagamento, permetto- 
no di gestire database senza limiti di dimen- 
sione e forniscono lo strumento Manage- 
ment studio che rappresenta una piattafor- 
ma completa di gestione per SQL Server. 
Trovate maggiori informazioni sulle differen- 
ze fra la versione Express e le altre nel box 
presente in questo stesso articolo. 



SQL NATIVE CLIENT 

SQL Native Client è la nuova tecnologia di 
accesso ai dati installata da SQL Server 2005. 
Essa racchiude in un'unica libreria, le carat- 
teristiche del provider SQL OLE DB del driver 
ODBC e nuove funzionalità. Poiché SQL 
Native Client non dipende esplicitamente da 
una particolare versione di MDAC (Microsoft 
Data Access Components) è ancora possibile 
utilizzare la versione di MDAC installata sul 
nostro computer. Quindi si può accedere ad 
SQL Server 2005, utilizzando direttamente le 
vecchie tecnologie di accesso, che però non 
permettono di utilizzare le nuove features 
quali XML data type, gli UDT (tipi definiti 
dall'utente) i multiple active resultsets 
(MARS) ecc. 

Un'altra feature introdotta con SQL Native 
Client è legata al trasporto dei database, con 
SQL 2005 tutte le informazioni del database 
possono essere racchiuse e trasportate nel 




EQUISITI DI SISTEMA PER SQL SERVER 2005 



PROCESSORE 


Premium Edition 


possono essere eseguiti sui 


Velocità 500 MHz o 


• Windows 2000 Server 


sistemi operativi indicati 


superiore (consigliato a 1 


• Windows 2000 


sopra e in più sui seguenti 


GHz o superiore) 


Advanced Server 


sistemi operativi: Windows 




• Windows 2000 


XP Home Edition e 


SISTEMI OPERATIVI 


Datacenter Server 


Windows Server 2003 Web 


SQL Server 2005 Enterprise 




Edition. 


Edition e Standard Edition 


SQL Server 2005 Standard 




possono essere eseguiti sui 


Edition può essere 


MEMORIA 


seguenti sistemi operativi: 


eseguito anche su Win- 


Express Edition: 128 MB 




dows XP Professional 


(consigliata da 512 MB in 


• Windows Server 2003 


Service Pack 2 o 


su). Tutte le altre versioni 


Standard Edition 


successivo. 


512 MB (consigliata da 1 


• Windows Server 2003 




GB in su) 


Enterprise Edition 


SQL Server 2005 Evaiuation 




• Windows Server 2003 


Edition e Workgroup 


SPAZIO SU DISCO 


Datacenter Edition 


Edition possono essere 


350 MB di spazio libero su 


• Windows Small 


eseguiti anche su Windows 


disco rigido per 


Business Server 2003 


2000 Professional. 


l'installazione completa. 


Standard Edition 




Per installare i database di 


• Windows Small 


SQL Server 2005 Developer 


esempio sono necessari 


Business Server 2003 


Edition ed Express Edition 


390 MB. 

J 
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file MDF. Questo, sicuramente, rappresenta 
una rivoluzione per gli sviluppatori di Web 
Applications che potranno mantenere una 
copia del file MDF in una directory del sito 
ed utilizzarla come un file Microsoft Access. 
Naturalmente anche in questi scenari SQL 
Server deve essere sempre disponibile. 



SQL SERVER 
MANAGEMENT STUDIO 

Le principali funzionalità dell'ambiente di 
sviluppo di SQL Server 2005 sono accessibili 
mediante Management Studio. 
Potremmo definire Management Studio co- 
me la centrale di controllo di Microsoft SQL 
Server, esso offre tutti gli strumenti per ese- 
guire e monitorare le funzioni vitali di SQL 
Server. Management Studio combina in un 
unico ambiente le funzionalità che nelle pre- 
cedenti versioni di SQL Server erano offerte 
da Enterprise Manager, Query Analyzer e 
Analysis Manager. In questo modo, gli ammi- 
nistratori di database dispongono di un'uni- 
ca utilità completa ed integrata, che combina 
strumenti grafici di facile utilizzo. 
Per avviare SQL Server Management Studio, 
si deve cliccare sul pulsante Start della barra 
delle applicazioni, scegliere Tutti i program- 
mi Microsoft SQL Server 2005 e quindi SQL 
Server Management Studio. 



IL COMPONENTE 
ESPLORA OGGETTI 

Il componente principale di SQL Server Ma- 
nagement Studio è il componente Esplora 
oggetti. 

Esplora oggetti è uno strumento integrato 
che presenta un'interfaccia utente in grado 
di visualizzare e gestire gli oggetti in qualsia- 
si tipo di server. 

La struttura di Esplora oggetti è quella classi- 
ca in cui le informazioni sono raggruppate in 
cartelle. Per espandere le cartelle, in modo da 
visualizzare informazioni più dettagliate, si 
deve cliccare sul segno più (+) o fare doppio 
clic sulla cartella. 
La prima volta che si espande una cartella, 
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Fig. 1: La GUI di Management Studio 



LE PRINCIPALI NOVITÀ DI SQL SERVER 2005 



Sql Server 2005, rappresenta 
senza dubbio un elemento di 
rottura rispetto alle preceden- 
ti versioni e per più di un mo- 
tivo. Prima di tutto ne esiste 
una versione "Express" com- 
pletamente gratuita scaricabi- 
le all'indirizzo 
http://msdn.microsoft.com 
/vstudio/express/sql/default.aspx . 
La versione Express è identica 
in tutto e per tutto alle altre 
edizioni di SQL server. Le 
limitazioni riguardano: il nu- 
mero di CPU utilizzabili, in 
SQL Server Express è possibile 
utilizzare una sola CPU, la 
quantità massima di memoria 
utilizzabile limitata ad 1 GB 
per la versione Express, 
l'assenza di tool aggiuntivi 
quali: "Analysis Services, Re- 
porting Services, Data Trans- 
formation Services, Notifica- 
tion Services". Nonostante 
questo, SQL Server Express 



rappresenta un ottimo punto 
di ingresso per chi vuole pro- 
vare a sviluppare applicazioni 
che facciamo uso di Database 
in tecnologia Microsoft. In 
caso di utilizzi avanzati si po- 
trà comunque upgradare a 
versioni più evolute senza 
troppi problemi. Rispetto alle 
versioni precedenti SQL Ser- 
ver 2005 si caratterizza per di- 
ventare una completa piat- 
taforma di sviluppo. In parti- 
colare le funzionalità più in- 
teressanti sembrano essere la 
presenza di un "Service Bro- 
ker" all'interno dell'erigine, 
che consente di aggirare i li- 
miti dell'assenza di connetti- 
vità in situazioni di ambienti 
distribuiti. In sostanza il Ser- 
vice Broker gestisce una coda 
interna di richieste che ver- 
ranno eseguite non appena le 
condizioni lo consentiranno, 
ad esempio al ritorno della 



piena connettivitità o quando 
il server sarà abbastanza sca- 
rico per effettuare le opera- 
zioni in modo corretto. Ovvia- 
mente in assenza di connes- 
sione non sarà possibile effet- 
tuare nessuna richiesta a un 
server esposto in rete, questo 
problema si aggira installan- 
do un SQL Server locale alla 
macchina, effettuando la ri- 
chiesta al Server locale che 
gestirà la coda, ed al ritorno 
della connessione provvederà 
ad aggiornare il server remo- 
to. I costi sono ovviamente 
nulli essendo il server locale 
in versione Express. Un'ulter- 
iore importante innovazione 
è quella relativa ai tipi di dati, 
accanto al tradizionale T-SQL 
è ora possibile scrivere delle 
query molto complesse uti- 
lizzando direttamente il Fra- 
mework .NET. Infine c'è un'al- 
tra integrazione con XML, 



adesso maneggiato in modo 
nativo e quindi facilmente ac- 
cessibile e manutenibile. Ulte- 
riori novità sono rappresenta- 
te dagli Integration Services 
ovvero un sistema di integra- 
zione che consente tramite un 
linguaggio batch di sviluppa- 
re procedure ad Hoc per la 
conversione di sistemi etero- 
genei. In questo modo è per 
esempio possibile ricevere 
elementi da un ocr, piuttosto 
che da un file .csv per poi farli 
confluire tramite IS in un uni- 
co sistema. Della possibilità 
di salvare i dati in file esterni 
con estensione .mdf estrema- 
mente portabili con la logica 
dei vecchi file mdb, parlere- 
mo direttamente nel corso 
dell'articolo. 

Altri elementi che non citia- 
mo sono quelli di reportistica 
e analisi di cui ci occuperemo 
successivamente. 
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Esplora oggetti chiederà al server le informa- 
zioni per popolare la struttura, nel frattempo 
è possibile eseguire altre funzioni. 
L'elenco del contenuto delle cartelle non 
viene aggiornato automaticamente in modo 
da risparmiare risorse, nel caso in cui vi siano 
molti oggetti da visualizzare. 
Per aggiornare l'elenco degli oggetti all'inter- 
no di una cartella, cliccare con il pulsante 
destro del mouse sulla cartella e quindi sce- 
gliere Refresh. Quando Esplora oggetti è con- 
nesso a un server è possibile aprire una 
nuova finestra Editor del codice. Per aprire la 
finestra di Editor del codice, si deve cliccare 
con il pulsante destro del mouse sul nome 




■OVI STRUMENTI 



Gli strumenti ora incorporati in SQL 
Server Management Studio sono: 

EDITOR DEL CODICE 

Un editor completo per la scrittura 
e la modifica degli script che 
sostituisce Query Analyzer, incluso 
nelle versioni precedenti di SQL 
Server. SQL Server Management 
Studio include quattro versioni di 
Editor del codice: l'editor di query 
SQL, l'editor di query MDX, l'editor 
di query XMLA e l'editor di query 
SQL Mobile. 






ESPLORA OGGETTI 

Per l'individuazione, la modifica, la 



creazione di script o l'esecuzione 
di oggetti appartenenti a istanze 
di SQL Server. 

ESPLORA MODELLI 

Per l'individuazione e la creazione 
di script di modelli. 

ESPLORA SOLUZIONI 

Per l'organizzazione e l'archiviazio- 
ne di script correlati come parti 
di un progetto. 

FINESTRA PROPRIETÀ 

Per la visualizzazione delle pro- 
prietà correnti degli oggetti 
selezionati. 



J 
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Fig. 2: L'editor del codice 

del server in Esplora oggetti e quindi sceglie- 
re New query. La finestra delle query è solita- 
mente divisa in tre riquadri. Il riquadro a 
sinistra consente di esaminare oggetti dispo- 
nibili sull'istanza del server del database 
selezionato. Si deve utilizzare il riquadro in 
alto a destra per immettere le query. Il riqua- 
dro in basso a destra mostra i risultati. Dalla 
barra degli strumenti si può selezionare un 
database tra quelli disponibili. 



AL DATABASE 
DA VISUAL BASIC 

La prima azione da eseguire quando si vuole 
utilizzare una fonte dati è quella di aprire 
una connessione verso quest'ultima, ciò 
significa creare un oggetto SqlConnection, 
impostare la stringa di connessione, tramite 
la proprietà ConnectionString, ed aprire la 



CREAZIONE DI UN DATABASE SQL SERVER 2005 

Ecco i passi necessari per creare un nuovo database in SQL Server 2005 

> INIZIAMO > UN NUOVO DB > QUALE NOME? 
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La prima operazione da compiere è Clicchiamo con il tasto destro del mou- Nella finestra di dialogo NewDataba- 

quella di espandere il ramo del Server se sulla cartella Databases, e dal me- se è possibile selezionare, dall'albero 

fino alla cartella Databases. nu contestuale selezioniamo la voce: New di sinistra, tre differenti sezioni. Nella sezio- 

Otterremo l'elenco dei Database già creati Database. In questo modo si aprirà la fine- ne General dobbiamo indicare il nome logi- 

nell'ambiente. stra di dialogo New Database. co del nuovo db ad esempio: MiaRubrica. 
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connessione tramite il metodo Open. 
Per operare in modalità connessa, questi 
punti devono essere eseguiti soltanto alla par- 
tenza dell' applicazione, mentre alla fine del- 
l'applicazione si deve chiudere la connessio- 
ne tramite il metodo Close. Per operare in 
modalità disconnessa, invece, i punti prece- 
denti devono essere eseguiti ogni volta che si 
deve accedere al database. In pratica, ogni 
volta che si deve accedere ad un database si 
devono scrivere le seguenti istruzioni: 

Dim ObjConnection As New SqlConnection() 
ObjConnection.ConnectionString = "Initial 

Catalog = MiaRubrica;Data 
Source=localhost; Integrateci Security=SSPI;" 
ObjConnection. Open() 
'operazioni su database 



ObjConnection. CloseQ 





tSubt 

Basic 



prietà CommandText, si deve utilizzare uno 
dei relativi metodi Execute: 

• ExecuteNonQuery si utilizza per inviare 
una query d'azione, e restituisce il numero 
di record coinvolti. Permette attività di 
manipolazione di dati, corrispondenti alle 
istruzioni SQL di Insert, Update e Delete. 

• ExecuteReader si utilizza per inviare una 
query di selezione, e restituisce l'oggetto 
DataReader che consente di accedere al 
set dei risultati (resultset). 

• ExecuteScalar si utilizza per inviare una 
query di selezione, e restituisce un singolo 



IGRARE DA ACCESS A SQL SERVER 2005 



L'OGGETTO SqlCommand 

Per interagire con un database, VB.Net mette 
a disposizione l'oggetto SqlCommand. 
L'oggetto SqlCommand deve essere associato 
ad un oggetto SqlConnection, preventiva- 
mente connesso alla sorgente dati, e può con- 
tenere una query di selezione (per leggere i 
dati dal database) o una query d'azione (per 
aggiornare i dati), impostata tramite la pro- 
prietà CommandText. 

Dopo aver impostato l'oggetto SqlCommand, 
ed aver impostato la query mediante la pro- 



La migrazione è veramente sempli- 
ce. Esiste un tool apposito nel me- 
nu strumenti di Access 2000 chia- 
mato Upsizing Tool che vi guiderà 
passo passo all'upgrade. Se invece 
disponete di un Access 97 sarà ne- 
cessario scaricare l'apposito tool, 
l'indirizzo di riferimento è il se- 
guente: http://www.microsoft.com 
/products/developer/officedeveloper 
/access/prodinfo/aut97dat.htm. Nelle 
nostre prove non abbiamo verifica- 
to nessun problema di perdita di 
dati nell'upsizing. Il tool si compo- 
ne di pochi passi che vi invitano a 



selezionare le tabelle origine e de- 
stinazione. Al termine dell'esporta- 
zione otterrete il nuovo database e 
un file di LOG che contiene l'esito 
dell'esportazione tabella per tabel- 
la. In un solo caso abbiamo incon- 
trato una difficoltà, ovvero con 
una tabella di un db Access 
chiamata "file" in tal caso viene 
generato un conflitto di tipi e 
l'esportazione non va a buon fine. 
In questi rari casi è sufficiente 
rinominare le tabelle che generano 
il conflitto per risolvere il 
problema. 



> DOVE POSIZIONARE IL FILE 




□ Use full-texl 
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Add | Remove | 



OK [ Cancel 



Nella parte inferiore, del- 
la sezione General, spo- 
stando la barra di scorrimento ver- 
so destra alla voce path possia- 
mo cambiare il percorso del fi- 
le fisico costituente il databa- 
se, con valori diversi da quelli 
proposti per default (per il nostro 
esempio lasciamo quelli propo- 
sti). Possiamo, inoltre, cambia- 
re la dimensione iniziale (ad es. 
5 MB), ed attivare l'opzione di 
crescita automatica delle di- 
mensioni del database. In ge- 
nerale è consigliabile imposta- 
re un aumento in termini per- 
centuali 



> LE PROPRIETÀ 
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Nella sezione Opzioni possiamo modifica- 
re alcune proprietà relative ad esempio al- 
l'update del database, per il nostro esempio la- 
sciamo quelle di default. 
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valore risultato di un'istruzione Select (da 
usare, ad esempio, se il risultato è il frutto 
di query con clausole di aggregazione co- 
me count o sum). 

L'oggetto SqlCommand espone diverse pro- 
prietà, tra queste: 

• CommandText permette di impostare l'i- 
struzione SQL della query o la stored pro- 
cedure da eseguire sull'origine dati. 

• CommandType permette di impostare il 
valore che indica in che modo interpretare 
il tipo di query impostato nella proprietà 
CommandText, può assumere i valori: 
Text, StoredProcedure 



proprietà fondamentali CommandText e 
SqlConnection. 

• Eseguire il comando Sql tramite il metodo 
ExecuteNonQuery, che restituisce il nume- 
ro di record coinvolti dall'istruzione 

Inseriamo, ad esempio, una nuova persona 
nel database MiaRubrica. 
La prima operazione è quella di costruire la 
stringa corrispondente all'istruzione Sql di 
inserimento (Insert) 

Dim QuerySql As String 

QuerySql = "INSERT INTO Persona (CodicePersona, 

Nome, Cognome, NumeroTelefono)VALUES 



( l,'FedericayBuonoy098222222')" 



Connection rappresenta l'oggetto SqlCon- 
nection associato all'istanza corrente del- 
l'oggetto SqlCommand. 

Parameters contiene la collezione di tutti i 
parametri principali associati all'oggetto 
SqlCommand. 



INSERIRE O MODIFICARE 
UN RECORD 

Per eseguire una query di azione sul database, 
tipicamente si deve: 



Successivamente si deve creare un oggetto 
SqlCommand ponendo la proprietà Com- 
mandText pari alla stringa che definisce la 
query, e la proprietà SqlConnection pari 
all'oggetto objConnection creato nell'esem- 
pio precedente: 

Dim ObjCommand As New SqlCommand(QuerySql, 

ObjConnection) 

Infine si deve eseguire il comando Sql tramite 
il metodo ExecuteNonQuery, che restituisce il 
numero di record coinvolti dall'istruzione: 

Dim NumeroRecord As Integer 



Creare un oggetto SqlCommand con le NumeroRecord = ObjCommand. ExecuteNonQueryQ 



CREAZIONE DI UNA TABELLA 

Una volta creato il nostro Database dobbiamo definire le entità fondamentali che permetteranno di utilizzarlo: le tabelle 



> SCEGLIERE IL DB 

1 14111 ira 




K Selezioniamo il Database di esempio 
(MiaRubrica), espandiamo il ramo e clic- 
chiamo con il tasto destro del mouse sulla 
voce Tables. Dal menù contestuale possia- 
mo selezionare il menu: NewTable. 



> CREARE LE COLONNE 






sr ^L, 



ti 



Cliccando nel campo Data Type il si- 
stema mostra un menù con tutti i tipi 
di dati disponibili in SQL Server, da cui pos- 
siamo selezionare il tipo desiderato (ad esem- 
pio int oppure float). 



> DIMENSIONARE I DATI 




In base al tipo selezionato al passo 
precedente, apparirà, nella parte in- 
feriore della finestra, il campo Lenght che 
permetterà di specificare la lunghezza, o la 
lunghezza massima del campo 
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Seguendo lo stesso schema possiamo modifi- 
care un record della tabella persona, co- 
struendo la stringa corrispondente all'istru- 
zione Sql di aggiornamento (update) 

Dim QuerySql As String 

QuerySql = "update Persona set Nome ='Sara', 

Cognome= 'Buono', NumeroTelefono='556688' 
where CodicePersona = l" 
Dim ObjCommand As New SqlCommand(QuerySql, 

ObjConnection) 
Dim NumeroRecord As Integer 
NumeroRecord = ObjCommand. ExecuteNonQueryQ 



le persone presenti in MiaRubrica, si può 
scrivere: 

Dim QuerySql As String 

QuerySql = "select * from persona" 

Dim ObjCommand As New SqlCommand(QuerySql, 

ObjConnection) 
Dim ObjReader As SqlDataReader = 

ObjCommand. ExecuteReader() 

Analizziamo in dettaglio come utilizzare l'og- 
getto SqlDataReader per leggere il set di risul- 
tati ottenuto. 




Per eliminare un record, si deve seguire sem- 
pre lo stesso schema utilizzando l'istruzione 
SQL di cancellazione (delete Persona where 
CodicePersona-1). 



ESEGUIRE QUERY 
DI INTERROGAZIONE 

Per interrogare il database e leggere i dati si deve: 

• Creare un oggetto SqlCommand come ab- 
biamo visto in precedenza. 

• Eseguire la query Sql tramite il metodo 
ExecuteReader, ed assegnarlo ad un og- 
getto SqlDataReader per leggere il set dei 
risultati una riga per volta. 



L'OGGETTO 
SqlDataReader 

L'oggetto SqlDataReader viene utilizzato per 
leggere un set dei risultati di tipo forward-on- 
ly da un database SQL Server, a seguito di una 
query d'interrogazione. A differenza degli 
oggetti visti in precedenza non è possibile 
utilizzare un costruttore per creare un ogget- 
to SqlDataReader, ma è invece necessario 
chiamare il metodo ExecuteReader dell'og- 
getto SqlCommand. Tra le proprietà ed i 
metodi esposti dall'oggetto SqlDataReader 
segnaliamo: 

• FieldCount contiene il numero di colonne 
del record corrente. 



DOVE SI 
INSTALLA SQL 
SERVER? 

SQL Server 
Management Studio 
viene installato per 
impostazione 
predefinita in 
C:\Program 
Files\Microsoft SQL 
Server\90\Tools\Binn\VS 
Shell\Common7\IDE. 



Ad esempio, per eseguire una ricerca di tutte 



IsClosed contiene un valore, pari a True, se 



> LE CHIAVI PRIMARIE 



* - • I 



> SCEGLIERE IL NOME 
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rDopo aver completato la definizione 
dei campi, possiamo impostare la chia- 
ve primaria della tabella selezionando il cam- 
po (CodicePersona) e cliccando sull'icona a for- 
ma di chiave sulla barra degli strumenti, co- 
si come le altre impostazioni 



A questo punto possiamo assegnare 
un nome significativo alla tabella, ad 
esempio Persona, operando sulla finestra di 
dialogo di destra, la finestra Properties, e 
modificando il valore del campo Name nel 
modo più opportuno 



> SALVARE TUTTO 
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Infine dobbiamo salvare la tabella 
appena creata, cliccando sull'icona 
a forma di dischetto sulla barra degli stru- 
menti .A questo punto il nostro DB è crea- 
to e nel caso del formato MDF lo trovere- 
mo nella directory opportuna 
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il DataReader è chiuso. 

RecordsAffected contiene il numero di 
record modificati, inseriti o eliminati dal- 
l'esecuzione dell'istruzione SQL. 

Close chiude l'oggetto SqlDataReader e 
rilascia le risorse allocate. 
GetName contiene il nome della colonna 
con l'indice specificato. 

IsDbNull contiene un valore , pari a True, 
se la colonna contiene valori nulli. 



• verificare il relativo valore di ritorno per 
controllare se esistono altri risultati (nel 
caso sia pari a True) oppure si è arrivati 
alla fine e non c'è nessun' altra riga da leg- 
gere (se è False). 

Grazie al funzionamento del metodo Read è 
possibile creare un ciclo While.. End While 
basato sull'oggetto SqlDataReader. Per com- 
pletare l'esempio precedente, in cui si cercano 
tutti le persone presenti in MiaRubrica, possia- 
mo scrivere il seguente codice che mostra un 
messaggio per ogni persona in archivio: 



• Read sposta l'oggetto SqlDataReader al 
record successivo. Restituisce un valore 
pari a True se sono presenti altri record da 
elaborare, oppure False se si è arrivati alla 
fine del set dei risultati 

• GetValue contiene il valore della colonna 
con l'indice specificato nel suo formato 
nativo 

Al posto del metodo GetValue è possibile uti- 
lizzare uno dei numerosi metodi Get forte- 
mente tipizzati, come GetString o GetDeci- 
mal. In pratica c'è un metodo Get per ogni ti- 
po di dati gestito da VB oppure un metodo 
GetSql per ogni tipo di dati gestito da Sql Ser- 
ver. Questi metodi particolari dovrebbero es- 
sere sempre adottati, in quanto evitano gli er- 
rori di conversione provocati dalla perdita di 
precisione e generano codice più veloce. 



Dim CodicePersona, Nome, Cognome, 

NumeroTelefono As String 

While ObjReader.Read() 

CodicePersona = ObjReader.GetInt32(0) 
Nome = ObjReader.GetString(l) 
Cognome = ObjReader.GetString(2) 
NumeroTelefono = ObjReader.GetString(3) 
MessageBox.Show(CodicePersona & " " & Nome & 
" " & Cognome & " " & NumeroTelefono) 

End While 



Mentre si utilizza l'oggetto SqlDataReader, non 
è possibile eseguire alcuna operazione sull'og- 
getto SqlConnection associato, per questo è 
importante chiudere l'oggetto SqlDataReader 
quando non esistono più righe da elaborare, in 
modo da rilasciare le risorse (lato client e lato 
server) e rendere la connessione nuovamente 
disponibile per altri comandi: 

ObjReader-.CIoseQ 



IGLIORIE AL CODICE 



Per mantenere il codice il più com- 
patto possibile, si può utilizzare 
l'istruzione Imports che semplifica 
l'accesso alle classi, eliminando la 
necessità di digitare in modo espli- 
cito il nome completo del name- 
space che le contiene. Le istruzioni 
Imports devono sempre essere 
scritte nella parte superiore del file 



nel quale si vogliono utilizzare, 
prima di qualunque altro codice. 
Per queste ragioni, in tutti gli 
esempi di codice, è ragionevole 
assumere l'inserimento delle 
seguenti istruzioni Imports: 

Imports System .Data 

Imports System. Data. SqlClient 



UTILIZZARE L'OGGETTO 
SqlDataReader 

Per iterare sui singoli record di un set di risul- 
tati, utilizzando l'oggetto SqlDataReader, è 
sufficiente: 

• invocare il metodo Read per avanzare al 
record successivo nel set di risultati 



SQL SERVER 2005 

E VISUAL STUDIO 2005 

La nuova versione di Sql Server si caratterizza 
per un'integrazione estrema con il Visual 
Studio 2005 Express. All'interno dell'ambiente 
di fatto esistono una serie di Wizard che si pon- 
gono come punto nevralgico nella creazione di 
una qualunque applicazione. 
Di fatto Sql Server è talmente integrato che 
l'ambiente stesso di programmazione diventa 
anche il query builder e il project manager del 
database. Inoltre il provider è sufficientemente 
strutturato da consentire con semplici opera- 
zioni di Drag & Drop di realizzare procedure 
che altrimenti richiederebbero molte righe di 
codice. Ad esempio la creazione di una 
maschera di inserimento dati si riduce quasi 
esclusivamente a trascinare i campi del data- 
base sulla form. 

Luigi Buono 
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ORACLE 1 g XE: 
NUOVO E GRATIS 

ORACLE INTRODUCE UNA NUOVA VERSIONE DEL SUO DATABASE DOTATA DI FUNZIONALITÀ 
PER VELOCIZZARE E OTTIMIZZARE LO SVILUPPO. E RENDE IL TUTTO LIBERAMENTE 
UTILIZZABILE. UNA RIVOLUZIONE NEL CAMPO DEI DATABASE... 
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Oracle è da sempre sinonimo di database di 
qualità, così come MySQL e Postgres sono 
sinonimi di database gratuiti. Per colmare 
questa "lacuna", Oracle ha deciso di rendere la ver- 
sione lOgXE, express edition, gratuita da scaricare e 
utilizzare nelle applicazioni, senza bisogno di paga- 
re licenze. Si può quindi integrare la potenza di uno 
dei database più noti e autorevoli al mondo nei pro- 
getti che realizziamo. Inoltre, la versione lOg ha 
delle caratteristiche innovative rispetto alla prece- 
dente 9i che permettono di sfruttare meglio le ope- 
razioni che si compiono normalmente sui databa- 
se. Uno degli elementi che possiamo usare subito, è 
l'introduzione delle espressioni regolari nel lin- 
guaggio SQL e PL/SQL. Usando una sintassi simile a 
quella di molti linguaggi di programmazione e a 
Unix, permettono di eseguire query più facili ed 
efficaci lavorando direttamente sui dati. Migliorano 
le operazioni su oggetti di grandi dimensioni come 
i LOB. Considerando l'internazionalizzazione dei 
dati, ci sono nuove funzioni per eseguire l'ordina- 
mento a seconda della lingua scelta. E nuovi tipi di 
dato, binary_float e binary_double, per avere 
migliori precisione e performance. Operazioni di 
flashback per ritornare a stati precedenti di righe e 
tabelle o per vedere quando una riga è stata modifi- 
cata o ripristinare una tabella prima di una drop. 
L'elenco delle funzionalità introdotte è tale che 
nella New Features Guide ci sono 67 pagine solo per 
loro! 



ESPRESSIONI REGOLARI 

Una volta passate in rassegna alcune delle nuove 
caratteristiche di Oracle lOg, si può passare all'a- 
zione vedendo quanto siano facili e potenti da 
usare. Alcune funzionalità sono migliorie di opera- 
zioni già esistenti, altre sono novità assolute: è que- 
sto il caso delle espressioni regolari. Spesso capita 
di dover cercare tra i dati, tutti i valori che conten- 
gono alcune lettere. Ad esempio, una query come: 

SELECT campo FROM tabella WHERE campo LIKE x %fra%'; 



potrà restituire valori come francia, afragolese, 
affranto ecc. Cioè tutti i valori che contengono "fra". 
Le espressioni regolari servono proprio a potenzia- 
re questo meccanismo per vedere se certi termini 
sono presenti, in che posizione compaiono oppure 
sostituirli. Il grande vantaggio è che si può lavorare 
direttamente nel database senza perdere tempo a 
prelevare il dato, modificarlo o verificarlo con i lin- 
guaggi di programmazione come java o c# e poi, 
magari, inserirlo nuovamente nel database. 
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MyWebServicel endpoint 



For a formai definitori, please reviewthe Service Description {rpc styie). 

MyWebSe rvicel service 



The following operations are supported. 

• insertClob 

• getCa; eListLike 

• getCa /e List 

• getUpperList 

• returnToPast 

• getValidMail 

• getCase , ansitiveList 

• getBinaryFloatSurn 

• rnakeBinaryFloatSurn 

• getLastDotList 

• getNurnberValueList 

• getLastModificationList 

• getString 

- nPtragpgJPngitivpl i<=t 



Fig. 1: Web servi ces dell'applicazione 

Per prendere confidenza con le espressioni regola- 
ri si può vedere la prima funzione realizzata nel 
progetto che consente di prelevare tutti i dati di un 
campo che iniziano con la lettera maiuscola. L'ap- 
plicazione, scritta in java, prevede una classica ese- 
cuzione di una query usando Statement e Re- 
sultSet. 

//OracleDAO. getUpperListQ 

rs = stmt.executeQuery("SELECT * " + "FROM prova 
" + "WHERE REGEXP_LIKE(prova, ,A [[:upper:]]')"); 

Come si può notare, accanto agli elementi caratteri- 
stici delle query, ci sono REGEXP_LIKE che richiama 
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le espressioni regolari e poi la combinazione di alcu- 
ni elementi. A [[:upper:]] significa che il primo valore, 
specificato dal simbolo A , deve essere di tipo upper, 
cioè maiuscolo. In modo del tutto analogo si posso- 
no cercare stringhe che contengano caratteri alfanu- 
merici, solo numeri, spazi o punteggiatura. Tutto ciò 
è una grande innovazione rispetto al vecchio SQL 
che ha potenzialità decisamente più limitate. Se 
invece si deve considerare l'ultimo valore della strin- 
ga allora si usa $. Mettendo insieme queste conside- 
razioni, e cercando di ottimizzare il tempo di esecu- 
zione, facendo lavorare il database, si passa al meto- 
do successivo che seleziona tutti i dati che sono delle 
mail sintatticamente valide. In una forma semplice, 
una mail è una sequenza del genere: renato@rossi.it 
con un dominio separato dal punto e con una @. 
Anche in questo caso Fuso delle espressioni regolari 
consente di scrivere una query semplice: 

//OracleDAO.getValidMailListQ 

rs = stmt.executeQuery("SELECT * " + "FROM prova 
" + "WHERE REGEXP_LIKE(prova, " + '"[[:alnum:]] + 
@[[:alnum:]]+ [.][[:alnum:]]')"); 

nella quale si identificano gli elementi fissi come la 
@ e quelli parametrici come [[:alnum]] che conside- 
rano valori alfanumerici. Altre espressioni regolari 
permettono di trovare il punto in cui l'espressione 
stessa è soddisfatta, come ad esempio l'indice del- 
l'ultimo punto di una stringa. Nell'esempio di pri- 
ma, renato@rossi.it, il punto si trova in posizione 13. 

//OracleDAO.getLastDotListQ 

rs = stmt.executeQuery("SELECT REGEXP_INSTR" + 
"(prova, , ([.][[:alnum:]]+)$') " + 
"as ind from prova"); 

In questo caso, oltre ai simboli già visti, c'è anche il + 
che significa che l'elemento precedente, un caratte- 
re alfanumerico, deve comparire almeno una volta. 



dovevano usare 2 metodi di 2 oggetti diversi (java.sql 
.PreparedStatement e oracle.sql.CLOB). Ora queste 
chiamate sono diventati trasparenti grazie all'uso di 
una proprietà della connessione. 

//OracleDAO.prepareConnectionO 
Properties props = new Properties(); 
props.put("SetBigStringTryClob", "true"); 

Il resto del codice è, a questo punto, del tutto identi- 
co all'inserimento di una normale stringa di dimen- 
sione qualsiasi. 



//OracleDAO.insertClob(String str) 
pstmt = con.prepareStatement( 
"INSERT INTO prova (prova, clobcolumn) 

VALUES('test clobl', ?)"); 

pstmt. setString(l, str); 
pstmt. executeUpdate(); 



Con i metodi prepareStatement e setString si impo- 
sta la query per inserire nel campo clobcolumn della 
tabella prova il valore str che è una String di dimen- 
sioni qualsiasi. A volte capita di dover registrare un 
file, ad esempio xml, di dimensioni variabili: in que- 
sto modo non serve più discriminare via codice sulla 
dimensione del file: fa tutto Oracle. 
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URL PER 
INIZIARE 

Il sito della Oracle con- 
tiene le informazioni 
necessarie per lavorare 
al meglio con il data- 
base 10g. 

Ci sono le informazioni 
generali e i link dove 
poter scaricare il data- 
base. 

http://www.oracle.com/da 
tabase/index.html 
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Fig. 2: La console di amministrazione di Oracle xe 



LARGE OBJECTS 

Un'altra situazione comune è quella di dover me- 
morizzare, nei database, grandi quantità di dati sot- 
to forma di molti kb di testo, immagini, video o suo- 
ni. Oracle supporta questo tipo di memorizzazione 
con l'introduzione dei LOB, Large Objects, che pos- 
sono essere di 3 tipi: BLOB, BinaryLOB, CLOB, Cha- 
racterLOB, e NCLOB, National Character LOB. I no- 
mi suggeriscono il formato che viene usato per me- 
morizzare il dato, binario o testuale, e il tipo di na- 
zionalità del carattere specificato dal database. Un 
caso che si può presentare è quello di registrare un 
file xml nel database e il problema avviene alla soglia 
dei 32765 byte. Infatti, a seconda se il file aveva 
dimensione maggiore o minore di questo valore si 



GLOBALIZZAZIONE 
E RICERCHE 

Con questo termine, o con internazionalizzazione, si 
intende il processo di rendere il programma adatto 
per qualsiasi lingua, considerando anche i caratteri 
speciali propri di ogni nazione, come ad esempio la 
"a". Quando si devono effettuare ricerche sui dati 
immettendo parte del nome oppure si devono ritor- 
nare liste ordinate alfabeticamente, allora possono 
essere utili le funzioni di globalizzazione. Conside- 
riamo il caso in cui dobbiamo prendere una lista di 
valori ordinata alfabeticamente. Se non si imposta 
nessuna condizione specifica, la lista restituita pre- 
senterà prima i valori numerici, poi le stringhe che 
iniziano con la lettera maiuscola, poi quelle con la 
lettera minuscola, infine lettere speciali accentati e 
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URL PER LA 
DOCUMENTA- 



II sito della Oracle per- 
mette di accedere a 
tutta la documentazio- 
ne immaginabile sulle 
varie versioni del data- 
base. Si trovano guide 
specifiche per ammini- 
stratori, sviluppatori, 
aspetti specifici come i 
LOS, OLAP, SQL, XML. 
http://www.oracle.com/pls 
/db10g/portal.portal 
demo3?selected=3 



di lingue estere. In questo modo l'ordinamento è 
case sensitive. 

10 

Ale 

CIAO 

Ciao 

Ciao 

ale 

ciao 

ciao stai come 

àie 

ale 

Usando l'SQL standard si possono ottenere risultati 
migliori, ma che non coprono tutti i casi possibili. 
Con le funzionalità di globalizzazione si possono 
valutare molteplici soluzioni che vanno incontro a 
tutte le esigenze. Iniziando dal caso più facile, si 
possono ordinare i valori in modalità case insensiti- 
ve. 

10 

ale 

Ale 

Ciao 

Ciao 

CIAO 

ciao 

ciao stai come 

àie 

ale 

In questo modo quello che si vede è una lista nella 
quale ci sono sottoliste di stringhe che iniziano tutte 
con la stessa lettera, indipendentemente dal fatto 
che sia maiuscola o minuscola. Resta fuori ancora 
qualcosa. Si possono vedere gi ultimi valori: inizia- 
no con lettere accentate, non importa se sono lette- 
re dell'alfabeto italiano o meno. A volte si devono 
poter mettere anche queste parole nel gruppo di 
quelle che iniziano con "a". Ecco allora che una pic- 
cola variazione della funzione restituisce l'effetto 
desiderato per ottenere un ordinamento sia case 
insensitive che accent insensitive. 

10 

ale 

Ale 

àie 

ale 

CIAO 

Ciao 

Ciao 

ciao 

ciao stai come 

Considerando gli obiettivi, si può andare a vedere il 



codice che genera questi tre risultati. I tre metodi si 
trovano tutti nella classe OracleDAO e hanno nomi 
che ricordano la ricerca che viene effettuata, cioè 
una lista "case sensitive", "case insensitive" e "case e 
accent insensitive". 

//OracleDAO. getCaseSensitiveList() 

rs = stmt.executeQueryC'select prova from prova "); 

//OracleDAO. getCaseInsensitivel_ist() 
rs = stmt.executeQueryC'select prova from prova " + 
"order by nlssort(prova,'nls_sort=binary_ci')"); 

//OracleDAO. getCaseAccentInsensitiveList() 
rs = stmt.executeQueryC'select prova from prova " + 
"order by nlssort(prova,'nls_sort=binary_ai')"); 

Come si può vedere dal codice, la funzione che per- 
mette l'ordinamento è nlssort che prende il campo 
sul quale effettuare l'ordinamento e il tipo di ordi- 
namento che è specificato da nls_sort. Alcuni tipi di 
ordinamento sono ci, case insensitive e ai, accent 
insensitive. Volendo si possono impostare parame- 
tri specifici per ogni nazionalità. Un modo alternati- 
vo per eseguire le query impostando prima il tipo di 
ordinamento consiste nel modificare le impostazio- 
ni del database. 

alter session set NLS_SORT=BINARY_CI; 

Questa istruzione può essere lanciata dal database 
oppure inserita in una query apposite e lanciata dal 
programma java. Infine si può considerare il caso 
che unisce alcune caratteristiche impiegate fino ad 
ora. Una situazione frequente prevede la ricerca di 
una stringa in modalità case insensitive. Ad esem- 
pio la ricerca di tutte le parole che contengono "ci" 
sia nel caso di lettere maiuscole che minuscole. 
Usando solo le espressioni regolari otterremmo 
tutte le righe con "ci" minuscole. Fondendo insieme 
il potere espressivo delle espressioni regolari con le 
funzionalità di globalizzazione, si ottiene il risultato 
desiderato. 

//OracleDAO. getCaseInsensitivel_istLike(String name) 

rs = stmt.executeQueryC'select prova from prova " + 

"where REGEXP_LIKE(prova,"' + name + "','i')"); 

Come si può vedere dal codice, è tutto molto sem- 
plice: una combinazione di REGEXP_LIKE con la 
globalizzazione data dal parametro "i" alla fine che 
indica la ricerca case insensitive. 



FLASHBACK 

Lavorando con i database si conosce bene il rischio 
di modifiche ai dati. A volta questi vengono cambia- 
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ti in modo non corretto dall'applicazione o dall'am- 
ministratore o magari cancellati e poi può diventa- 
re impossibile ricostruire la situazione o la storia di 
un record o di una transizione. Per poter gestire 
eventualità del genere, sin da Oracle 9i ci sono delle 
operazioni che consentono di recuperare il vecchio 
stato dei record. Con la versione lOg le funzionalità 
sono aumentate e diventa facile riportare il databa- 
se, una tabella o una singola riga al momento desi- 
derato. Una delle informazioni che si possono avere 
è data e ora dell'ultima modifica delle righe della 
tabella. 

//OracleDAO.getLastModificationListQ 

rs = stmt.executeQueryC'select 

scn_to_timestamp(ora_rowscn), prova " + 
"from prova "); 
while (rs.next()) { 
lastModificationList.add(rs.getString(l)+ ", " 

+ rs.getString(2)); 
} 

In questo metodo ci sono due elementi caratteristi- 
ci di Oracle: scn_to_timestamp e orajrowscn. ora_ 
rowscn è una pseudocolonna, come rowid, che defi- 
nisce il System Change Number, SCN, cioè il nume- 
ro del cambiamento più recente. Il valore viene 
incrementato ogniqualvolta avviene un'operazione 
di commit. In questo modo si può gestire meglio 
anche la transazionalità di un operazione: infatti si 
può prendere questo valore prima di eseguire le 
operazioni, eseguirle senza fare commit, verificare 
che nessun altro abbia cambiato la tabella vedendo 
se il valore è sempre lo stesso, infine eseguire il 
commit. Prima di orajrowscn, per verificare se vi 
erano stati cambiamenti si doveva memorizzare i 
dati e confrontarli tutti. L'altro elemento usato è 
scnjojàmestamp che, come suggerisce il nome, 
serve per convertire il valore scn in un timestamp. Il 
metodo, nel caso specifico, serve per prendere tutte 
le righe della tabella e la loro data di ultima modifi- 
ca. I valori sono poi concatenati e aggiunti in una 
lista per essere visualizzati. Con questo metodo 
possiamo sapere quindi tutte le modifiche alle 
righe. Se invece si vuole recuperare lo stato della ta- 
bella, riprendendo i dati così come erano alcuni mi- 
nuti prima, si può usare il metodo returnToPast( 
String minuteAgo). 

Il OracleDAO.returnToPast(String minuteAgo) 
pstmt = con.prepareStatement( 
"INSERT INTO provaflashback (prova) 

(SELECT prova FROM prova AS OF TIMESTAMP 
(SYSTIMESTAMP - INTERVAL '" 
+ minuteAgo + "' MINUTE))"); 
pstmt. executeUpdate(); 

Con un PreparedStatement si può inserire nella 



tabella provaflashback tutti i valori della tabella 
prova come erano alcuni minuti prima. Il para- 
metro dei minuti è impostabile dall'utente ed è 
minuteAgo. In questo caso si usano sempre le 
potenzialità del flashback unite alla gestione 
delle date con systimestamp. Per poter eseguire 
operazioni di flashback si possono quindi usare 
sia i timestamp sia il valore scn: la differenza non 
è casuale e Oracle consiglia di usare scn perché 
ha una precisione maggiore. Il meccanismo che 
permette di effettuare questi salti a stati prece- 
denti si basa sulla scrittura delle caratteristiche 
delle tabelle in file di flashback log e, quando si 
eseguono le operazioni i dati vengono rimessi 
per differenza da quelli presenti, ottimizzando 
quindi le risorse. Se ad esempio è cambiata solo 
una riga, sarà solo quella ad essere modificata e 
tutto il resto resterà immutato. Le operazioni di 
recupero possono essere compiute anche sul- 
l'intero database. 

FLASHBACK [DEVICE TYPE = <device type>] 

DATABASE 

TP [BEFORE] SCN = <scn> 

TO [BEFORE] SEQUENCE = <sequence> [THREAD 

= <thread id>] 
TO [BEFORE] TIME = '<date_stnng>' 

Dalla sintassi si può apprezzare come il flashback 
del database può essere eseguito usando sia il valo- 
re scn sia una data. 



'idJfl! nTni:J^!: 



ORACLG Database Express Edition 



Utente: PROVA 
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Spazio allocato: D00 MB 
Disponibile: 4.220 MB 
Limite fisico: 5. 120 MB 
Percentuale utilizzata: 18% 



Fig. 3: La console mostra la memoria utilizzata 



DATI NUMERICI 

I tipi di dato sono tanti e le caratteristiche che i valo- 
ri numerici possono assumere nelle applicazioni 
tendono a essere infiniti. Ecco perché si tenta di 
regolare i tipi numerici, come suggerisce IEEE che 
definisce lo standard per i valori binari in virgola 
mobile e che sono seguiti anche dai linguaggi di 
programmazione come java. In questo contesto 
fanno il loro ingresso 2 nuovi tipi di dato: BINA- 
RY_FLOAT e BINARY_DOUBLE. Usando questi tipi, 
anziché il generico NUMBER, si ottimizzano le pre- 
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stazioni in termini di velocità di calcolo, spazio oc- 
cupato e grandezza del valore memorizzato. E come 
per NUMBER c'è la funzione di conversione TO_ 
NUMBER, così ora si possono utilizzare TO_BINA- 
RY_FLOAT e TO_BINARY_DOUBLE. Naturalmente 
questi valori sono compatibili con le normali opera- 
zioni numeriche e di aggregazione come sum, avg, 
sin, cos. Collegati ai nuovi tipi di dato ci sono anche 
delle costanti che possono essere usate nelle query 
o nei constraint, quando si definiscono le tabelle. 
Anche questi sono del tutto simili a quelli usati nei 
linguaggi di programmazione: IS (NOT) INFINITE e 
IS (NOT) NAN, che verificano se un numero è o 
meno infinito o non è un numero. Mettendo tutto 
insieme si possono creare situazioni nelle quali i 
valori restituiti sono anomali. Infatti, se eseguendo 
la somma di valori BINARY_FLOAT il risultato è 
ancora un valore di dimensioni accettabili, allora lo 
possiamo memorizzare in tabella. Se invece il valo- 
re è troppo grande si potrebbe avere un valore di 
ritorno non numerico. 

BINFLOAT 

Inf 



Questo è il risultato che si ottiene usando la conso- 
le di amministrazione di Oracle; mentre Infinity è 
quello che si ottiene eseguendo il metodo dell'ap- 
plicazione. 

//ORacleDAO.getBinaryFloatSum() 
rs = stmt.executeQueryC'select binfloat from prova " + 
"where prova = 'somma'"); 

Un modo per evitare queste situazioni è quello di 
utilizzare IS NOT INFINITE e IS NOT NAN nella 
definizione della tabella. La sintassi di questi vinco- 
li utilizza la parola chiave check e si può trovare 
accanto ai vincoli primary key, not nuli o unique. 

create table floating_point_table ( 

floatNotNull binary_float constraint flt_null not nuli, 

floatUnique binary_float constraint flt_unq unique, 

floatCheck binary_float constraint 

flt_chk check (floatCheck is not NaN ) , 

doubleCheck binary_double constraint 

dbl_chk check (doubleCheck is not infinite) , 

floatPrimaryKey binary_float constraint 

flt_ floatPrimaryKey primary key); 



FACCIAMOLO CON JDEVELOPER 

Primi passi per creare un Web Services utilizzando lo strumento gratuito di Oracle 



> CREARE UNA NUOVA 
APPLICAZIONE 
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Per prima cosa si crea una nuova ap- 
plicazione. 



> IMPLEMENTARE 
IL CODICE 



public interface IMyWebServicel { 



public String getStringQ; 



public String[] getArrayStringQ; 



public String[] getUpperListQ; 



public String[] getValidMailQ; 



public String[] getLastDotListQ; 



public String[] getNumberValueListQ; 
public String insertClobQ; 



public String[] getCaseSensitiveList(); 



All'interno della classe appena creata 
potremo aggiungere il codice 



> CREARE UN NUOVO 
PROGETTO 



> CREARE UNA NUOVA 
CLASSE 




Poi un nuovo progetto tramite clic con Creazione di una classe che servirà per 



il tasto sinistro del mouse. 

> FAR PARTIRE 
L'APPLICATION SERVER 



esporre i web services. 

> APERTURA 
DEL BROWSER 
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Possiamo testare il codice con uno stru- 
mento interno al prodotto 




Cliccare sull'uri che compare per aprire 
il browser ed eseguire l'applicazione. 
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Questa definizione della tabella mostra come il 
campo floatCheck debba essere not NaN, cioè 
debba essere numerico e doubleCheck non debba 
essere infinito. Abbiamo visto con l'esempio di 
prima cosa vuol dire e quando accade che un valore 
è infinite, mentre il valore NaN si ottiene quando si 
eseguono operazioni matematiche che restituisco- 
no risultati indeterminati come ad esempio 0/0 
oppure infinito /infinito. 



L'APPLICAZIONE 

Fin qui abbiamo parlato delle novità di Oracle lOg 
riferendoci all'applicazione realizzata senza dire 
molto sull'organizzazione del software e sugli stru- 
menti che Oracle mette a disposizione dei program- 
matori per velocizzare lo sviluppo del codice. 
L'applicazione realizza dei web services che esporta- 
no tutte le funzionalità viste in precedenza ed è divi- 
sa in 3 file: 1) WebServiceClass, che esporta i servizi 
e li realizza; 2) OracleDAO, che accede al database 
per gestire le informazioni; 3) FileParser, che esegue 
il parsing di un file, anche xml, per eseguire l'inseri- 
mento del CLOB. WebServiceClass si occupa di 
coordinare tutte le chiamate a OracleDAO e 
FileParser. La stringa di connessione che contiene i 
parametri sul tipo di driver usato, thin, sul nome o 
indirizzo della macchina, localhost, sulla porta e sul 
database, 1521 e xe è utile se si vuole cambiare ser- 
ver o le altre caratteristiche. 

//OracleDAO. prepareConnection() 

String uri = "jdbc:oracle:thin:@localhost:1521:xe"; 

Può essere anche utile e riusabile l'oggetto FilePar- 
ser che, in modo veramente semplice, prende in in- 
gresso un file xml, che nel nostro caso va messo nella 
directory principale, e lo trasforma in una stringa da 
mettere poi nel database. 

//FileParser 

try { 

File file = 

new File("\\installlog.xml"); 
FileReader in = new FileReader(file); 
int e; 
sb = new String Buffer(); 

while ((e = in.readQ) != -1){ 

sb.append((char)c); 

} 

} catch (IOException ex) { 

System. out.println("Exception reading file" + ex); 
} 



Quello che avviene è la creazione di un oggetto di 
tipo File che legge un xml e lo converte in 
StringBuffer, salvo errori di tipo input/ output. 



L'AMBIENTE ORACLE 

Di Oracle possiamo usare il database lOg xe, gra- 
tuito, scaricabile da internet, e installarlo sul 
computer che vogliamo. Il processo di installa- 
zione è molto facile e, una volta completato, per- 
mette di accedere ai comandi, sia grafici sia a 
riga di comando, per lanciare e fermare il data- 
base e per far partire la console di amministra- 
zione. Da questa si può creare il nuovo utente di 
prova e le tabelle per eseguire l'applicazione. In 
allegato ci sono i file con le definizioni delle 
tabelle usate e alcuni dati per eseguire le opera- 
zioni dell'applicazione. Da console è facile ese- 
guire caricamento /scaricamento dati e export 
/import delle tabelle. Oracle permette lo svilup- 
po di applicazioni java con F ide JDeveloper ver- 
sione lOg che è gratuito. 

L'ambiente di sviluppo consente di creare facil- 
mente i web services e di lanciare velocemente 
l'applicazione, senza bisogno di deploy, grazie 
all'application server integrato in JDeveloper che 
si chiama OC4J Server. Quindi, per provare tutto 
il progetto, non serve installare altro. 



CONCLUSIONI 

Le caratteristiche di Oracle lOg sono molte e rive- 
stono ambiti diversi. Si va da quelle per gli ammi- 
nistratori a quelle per gli sviluppatori a quelle che 
consentono di migliorare le prestazioni e di otti- 
mizzare l'utilizzo delle risorse. 
Gli obiettivi che si è posta Oracle con la versione 
lOg, grid, sono di aumentare la sicurezza, le per- 
formance e la scalabilità usando un insieme di 
server per la gestione dei database. Potenzial- 
mente, si possono aggiungere o rimuovere com- 
puter o memoria ed il database automaticamente 
alloca le risorse sfruttando il massimo delle risor- 
se disponibili. Ci sono poi miglioramenti per la 
fase di tuning e di monitoring. 
Le variazioni a SQL che consentono agli sviluppa- 
tori di ottimizzare le operazioni da eseguire sui 
dati. Basti pensare che si stima che l'80% della 
logica applicativa è processare stringhe. Ecco allo- 
ra l'introduzione delle espressioni regolari e dei 
LOB. E anche le migliorie per il recupero dei dati 
modificati o la globalizzazione. E anche l'introdu- 
zione dei nuovi tipi di dato del tutto simili a quel- 
li già presenti nei linguaggi di programmazione. 
Infine forse la caratteristica che potrebbe far pro- 
pendere per un database Oracle: la sua gratuità 
per la versione xe. Se poi si aggiunge anche un 
ambiente che facilita lo sviluppo come JDevelo- 
per, ecco allora che ci sono tutte le basi per poter 
usare Oracle per confezionare un'applicazione 
dall'inizio alla fine. 

Cristiano Bellucci 





URL PER 
JDEVELOPER 

Il sito della Oracle 
fornisce la documenta- 
zione anche per il suo 
ide, JDeveloper. 

http://www.oracle.com 

/technology/obe 

/obel 01 3jdev/index.htm 

E anche l'uri per 

scaricarlo 

gratuitamente. 

http://www.oracle.com 

/technology/software 

/products/jdev/index.html 
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PHP SPEDISCE 
LE NEWSLETTER 

IMPLEMENTEREMO UN'INTERFACCIA WEB CHE CONSENTA AD UTENTI AUTORIZZATI 
DI INTERAGIRE CON IL SISTEMA, E UN ENGINE CHE SPEDISCE I CONTENUTI IN MODO 
UN PO' PARTICOLARE.... 




rima di ogni cosa chiariamoci le idee su quel- 
lo che vogliamo realizzare. Da un punto di 
vista delle pure funzionalità il nostro sistema 



dovrà: 

• Autenticare un amministratore 

• Consentire agli utenti autenticati di aggiungere 
una newsletter 

• Permettere di aggiungere /rimuovere gli utenti 

• Inviare le email in modo schedulato di modo 
che non si affolli il mail server 

In realtà la gestione degli utenti dovrà funzionare 
in modalità mista. In questo articolo non affronte- 
remo l'argomento, ma gli utenti dovrebbero poter- 
si iscrivere /rimuovere dalla newsletter tramite 
un'interfaccia web pubblica. Daremo per scontato 
che questa parte del sistema sia già implementata 
e funzionante. 



esigenze. Infine per fare funzionare bene smarty, 
avremo bisogno di creare le seguenti directory all'in- 
terno della root del nostro progetto 

templates 

templates_c 

configs 

la directory template_c dovrà essere accessibile in 
scrittura, conterrà infatti i file compilati di smarty. 
Anche in questo caso accenniamo brevemente a 
questa caratteristica ma non è nostro scopo 
approfondire il discorso dei template in questo 
momento. Poiché siamo in fase di definizione del 
progetto creiamo anche una directory "kernel" al cui 
interno inseriremo le classi che ci servono per la 
gestione del progetto. 



REQUISITI 



Conoscenze richieste 



— Basi di PHP 




GLI STRUMENTI 

Come sempre facciamo in questa serie di articoli su 
PHR ci faremo aiutare dalle classi Pear per agevola- 
re l'interfacciamento con i database e per gestire 
l'autenticazione, ed utilizzeremo Smarty per la 
gestione dei template e l'interfaccia Web. 
Al solito per installare le classi Pear che ci servono 
digiteremo da una console di sistema 

pear instali auth 
pear instali db 

Nel primo caso ci verrà richiesto qualche modulo di 
Storage supplementare, l'installazione è facoltativa, 
in questo articolo utilizzeremo un'autenticazione 
base che non richiede particolari attenzioni. 
Per quanto riguarda smarty invece, avremo cura di 
scaricarlo dal sito smartyphp.net, scompattarlo e 
copiare in una directory raggiungibile dal percorso 
di include del php, a tal proposito verificate nel 
php.ini quali sono le vostre directory di inclusione e 
adattatele in modo che siano conformi alle vostre 



L'AUTENTICAZIONE 

Prima di ogni cosa creiamo un file config.php all'in- 
terno della nostra directory kernel. Sarà qui che 
inseriremo le variabili globali, come ad esempio la 
stringa di connessione al database. Il nostro file con- 
fig.php conterrà 

<?php 

include_once("DB.php"); 

require_once("Auth/Auth.php"); 

require_once('Smarty.class.php'); 

$server = "localhost"; 

$database = "mailbot"; 

$username = "mailbot"; 

$password = "mailbot_pwd"; 

$dbh = DB::connect("mysql://$username: 

$password@$ server/$database"); 
$params = array( "dsn" => "mysql://$username: 

$password@$server/$database" , 



"table" => "auth" , 



"usernamecol" => "username" 



"password col" => "password", 



'db_fields' = >"*" 



); 
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$a = new Auth("DB", $params, "loginFunction"); 
?> 

in mysql creiamo un database chiamato mailbot 

mysqladmin -uroot -ppassword create mailbot 

e aggiungiamo i permessi per l'utente mailbot con 
password mailbot_pwd 

mysql -uroot -ppassword 

grant ali privileges on mailbot.* to mailbot identified 

by 'mailbot_pwd' 

e creiamo la tabella auth 

mysql -umailbot -pmailbot_pwd mailbot 

CREATE TABLE ^ autrT ( 
^IDJJSEFT bigint(20) NOT NULL auto_increment, 
'username' varchar(50) NOT NULL default ", 

* password * varchar(32) NOT NULL default ", 

* ROLE^ bigint(20) NOT NULL default T, 
PRIMARY KEY f IDJJSER^ / username* ), 
KEY " password * ( * password ' ) 

T~ 

A questo punto siamo pronti per generare il nostro 
file index.php che in un primo momento avrà que- 
sta forma: 



<? 


require_once('kernel/config.php'); 


$a- 


> sta rt() ; 


if ($_GET['action'] == "logout") { 


$a->logout(); 


$a->start(); 


} 


if ($a->getAuth()) { 


$smarty = new Smarty; 


function list_newsletter() { 


global $smarty,$db; 


$smarty->display('index.tpr); } 


switch ($_POST['operazione']) { { 


case "list_newsletter": 


list_newsletter(); 


break; 


default: list_newsletter(); 


break; } 


} 


?> 



http://localhost/mailbot/index.php e se tutto è 
andato a buon fine visualizzeremo la form per il 
login e saremo in grado di visualizzare il contenuto 
del file index.tpl solo se riusciremo ad autenticarci. 
Se tutto funziona correttamente il nostro modulo di 
autenticazione può considerarsi terminato. 



LA HOME PAGE 

Nella nostra home page desideriamo che dopo aver 
effettuato l'autenticazione, compaia una lista delle 
newsletter già inviate o pronte per l'invio, un link 
per la gestione degli utenti, e un link per l'aggiunta 
di una nuova directory. Creiamo la tabella in mysql 
che dovrà contenere le newsletter: 

CREATE TABLE * newsletter' ( 

% ID_NEWSLETTER* BIGINT NOT NULL 

AUTO_INCREMENT PRIMARY KEY , 
'TITOLO_NEWS' VARCHAR( 255 ) NOT NULL , 
'CORPO_NEWS' LONGTEXT NOT NULL 
) TYPE = MYISAM 

Poi creiamo un nuovo file all'interno della directory 
kernel, che si chiamerà newsletter. php. In questo file 
inseriremo le classi che ci serviranno per gestire il 
progetto. Inizialmente il suo contenuto sarà: 



<? 
include_once('kernel/config.php'); 
class newsletter { 

function store($titolo,$news) { 
global$dbh; 
$query = "INSERT INTO newsletter ( 

TITOLO_NEWS,CORPO_NEWS) values 

('$titolo'/$news')"; 

if ( DB::isError( $demoResult = $dbh->query( 

$query ) ) ) { 

echo DB: :errorMessage($demoResult); 

}}} 

?> 



Il file index.php dovrà essere modificato aggiungen- 
do un include per file newsletter.php 

require_once('kernel/newsletter.php'); 

aggiungiamo poi due funzioni per la gestione del- 
l'inserimento 







I TUOI APPUNTI 



global $_POST; 



$titolo= $_POST["titolo_news"] ; 



e aggiungiamo alla tabella auth un utente fittizio function sto re_news Ietterò { 

"admin" con password "admin" tanto per poter fare 

delle prove. Allo stesso modo creiamo un file fittizio 

index.tpl all'interno della directory templates al cui 

interno inseriremo una stringa casuale, anche in 

questo caso per poter testare il funzionamento del 

modulo di autenticazione. Puntiamo il browser su 



$contenuto= $_POST["content_news"]; 



$newsletter= new newsletter^); 



$newsletter->store($titolo,$contenuto); 



list_newsletter(); 
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> 



function a dd_news letterQ { 



MIGLIORIE 

Lo scheletro qui 

proposto potrebbe 

essere migliorato 

aggiungendo una 

funzione che 

garantisce di inviare un 

numero limitato di 

funzioni nel tempo, di 

modo che il mailserver 

non sia eccessivamente 

affollato. Per realizzare 

questa funzione si 

potrebbe aggiungere al 

db utenti un campo 

"news da inviare" e un 

campo 

"prossima_news" e poi 

agire su uno scheduler 

che a tempi 

determinati invia le 

email aggiornando i 

due campi 



global $smarty; 



$smarty->display('add_newsletter.tpl'); 



} 
e un case per gestire gli eventi 

switch ($_POST['operazione']) { 



case "add_newsletter": a dd_news letterQ; 



break; 



case "store_newsletter": store_newsletter(); 



break; 



case "list_newsletter": list_newsletter(); 



break; 



default: list_newsletter(); 



break; 



} 



non ci resta che sistemare i template. In index. tpl ci 
dovrà essere un combobox che ci mostra l'azione da 
compiere: 



<form method = "post" action = "index.php""> 
<select name="operazione"> 

<option value="add_newsletter">Aggiungi 

news</option> 
</select> 
<input type="submit"> 
</form> 



utilizzando questa form verrà richiamato ancora 
una volta index.php con il campo "operazione" 
posto a "add_newsletter". Questo fa si che quando 
index.php viene richiamato il controllo passi alla 
funzione add_newsletter() che mostra il contenuto 
di add_newsletter.tpl che a sua volta conterrà: 

<html> 
<body> 

<form method = "post" action = "index.php""> 

<input type="hidden" name="operazione" 

value="store_newsletter"> 
<table cellspacing = "2" class="fz"> 
<trxtdxlabel for="titolo_news">Titolo news: 

</labelx/td> 

<tdxinput type="text" name="titolo_news" 

maxlength="56" tabindex="l" /x/td> 

</tr> 

<trxtd>< label for="content_news">Corpo 

news:</labelx/td> 
<tdxtextarea name=content_news 

rows="15" cols="50"> 
scrivi qui 
</textarea> 
<input type="submit"> 
</td> 



</tr> </table> </form> </bodyx/html> 

a questo punto operazione cambia in "store_new- 
sletter" e quando il controllo tornerà al file index 
.php verrà richiamata la funzione store_newsletter() 
che prowederà tramite la classe che abbiamo crea- 
to in precedenza a salvare la newsletter sul nostro 
database. 

Il meccanismo di modifica e rimozione di una new- 
sletter segue lo stesso meccanismo e non ne parle- 
remo in questo articolo. Aggiungeremo invece alla 
classe un metodo fetchAllNewsLetter che ci consen- 
tirà di visualizzare l'elenco delle newsletter inserite. 
Per cui all'interno di newsletter. php aggiungeremo: 

function fetchAIINewsLetterO { 
global $dbh; 

$stmt="select * from newsletter)"; 
$dettagli_newsletter= $dbh->getAII($stmt, 

DB_FETCHMODE_ASSOC); 
return $dettagli_newsletter; 



la funzione list_newsletter di index.php diventerà 



function list_newsletter() { 

global $smarty,$db; 

$newsletter=new newsletter(); 

$allnews = $newsletter->fetchAIINewsLetter(); 

$smarty ->assign( "allnews" , $allnews); 

$smarty->display('index.tpr); 
} 

e potremo modificare index.tpl per listare tutte le 
newsletter presenti in archivio 



<form method = "post" action="index.php""> 
<select name="operazione"> 

<option value="add_newsletter"> Aggiungi 

news</option> 
</select> 
<input type="submit"> 
</form> 
<br> 

{section name="i" loop=$allnews> 
{$allnews[i].TITOLO_NEWS> 
<form method = "POST" action = "index.php"> 
<input type=hidden name="operazione" 

value="invia_news"> 
<input type=hidden name="id_news" 

value="{$allnews[i].ID_NEWSLETTER}"> 
<input type="submit" value=submit> 
</form> 
{/section} 
</form> 



Notate anche che abbiamo aggiunto un pulsante 
"submit" accanto al nome di ogni newsletter. 
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Questo pulsante una volta cliccato avrà la funzione 
di richiamare ancora una volta index.php e passargli 
in post il valore "operazione=invia_news", sempre in 
post gli passerà il valore id_news della news da 
postare. E' qui che potete eventualmente agire per 
aggiungere altri pulsanti che serviranno a loro volta 
per modificare/ eliminare una news. E con questo 
anche il modulo di amministrazione delle news è 
terminato. Non ci resta che passare al modulo send 
che servirà per inviare fisicamente la newsletter 



IL MODULO SEND 

Come sempre prima di ogni cosa creiamo una tabel- 
la mysql che conterrà il nome, il cognome, l'indiriz- 
zo email della persona che dovrà ricevere la new- 
sletter 



CREATE TABLE * user" ( 

^IDJJSEFT BIGINT NOT NULL AUTO_INCREMENT 

PRIMARY KEY , 
^ NOME^ VARCHAR( 100 ) NOT NULL , 
^COGNOME^ VARCHAR( 100 ) NOT NULL , 
'EMAIL' VARCHAR( 100 ) NOT NULL 
) TYPE = MYISAM ; 



Diamo per scontato che in qualche modo questa 
tabella sia stata riempita con valori opportuni. 
Tipicamente sarà riempita tramite la registrazione 
di un utente sul sito. Ovviamente trascuriamo in 
questa sede tutte le note sulla privacy etc. Siamo 
certi che siate nelle condizioni legali di poter inviare 
a questi utenti la vostra newsletter. 
A questo punto creeremo un nuovo file send.php 
all'interno del kernel che conterrà le classi per l'in- 
vio dell'email. Il nostro send.php inizialmente con- 
terrà il seguente codice: 

require_once("kernel/newsletter.php"); 
include_once('kernel/config.php'); 
class servermail { 

function send($ID_NEWS) { 

$ newsletter new newsletter^); 
$newsletter_to_send=$newsletter-> 

fetchNewsLetterByID($ID_NEWS); 
$usertosend=$this->fetchuser(); 
foreach ($usertosend as $user) { 
$from_name = "NewsLetter User"; 
$from_email = "ffarnesi@edmaster.it"; 
$subject = $newsletter_to_send[0][ 

TITOLO_NEWS']; 
$body = " = 



$body .= "\n"; 



MIME_BOUNDRY_message_parts\n" 



$body .= "Content-Type: text/plain; charset= 

\"iso-8859-l\"\n" 

$body .= "Content-Transfer-Encoding: 

quoted-printable\n" 



$body = $newsletter_to_send[ 

0]['CORPO_NEWS']."\n\n"; 

$headers = "From: $from_name 

<$from_email>\n"; 
il($user['EMAIL'],$subject,$body,$headers); 



» 



function fetchuserQ { 



global $dbh; 



$stmt="select EMAIL from user"; 



$userlist= $dbh->getAII($stmt, 

DB_FETCHMODE_ASSOC); 



return $userlist; 



}} 



?> 



chiaramente in index.php avremo 

switch ($_POST['operazione']) { 



case mvia_news 



invia_news(); 



break; 



e ancora 



function invia_news() { 



global $_POST; 



$ID_NEWS=$_POST["id_news"]; 



$sender= new servermail(); 



$sender->send($ID_NEWS);> 

ovviamente dovremo creare in newsletter.php il 
metodo fetchNewsLetterByID($ID_NEWS); che sarà 
il seguente 

function fetchNewsLetterByID($ID_NEWS) { 

global $dbh; 

$stmt="select * from newsletter where ID 

_NEWSLETTER='$ID_NEWS'"; 
$dettagli_newsletter= $dbh->getAII($stmt, DB_ 

FETCHMODE_ASSOC); 
return $dettagli_newsletter; } 

ed il gioco è fatto. Il metodo send non fa altro che 
costruire una lista degli utenti tramite un metodo 
interno fetchuser, recuperare il testo della newslet- 
ter, costruirla e inviarla. 



CONCLUSIONI 

In questo articolo abbiamo suggerito uno schema 
estremamente personalizzabile. Per adattarlo alle 
vostre esigenze tutto quello che è necessario fare è 
modificare i vari template ed aggiungere gli eventi 
nello switch di index.php, ovviamente non dimenti- 
cate di costruire i metodi opportuni nel kernel. 
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BLUETOOTH TRAMITE 
L'OBEX PROTOCOL 

METODI, CLASSI, TEORIA E TECNICHE NECESSARI AD IMPLEMENTARE IL TRASFERIMENTO 
DEI DATI IN DISPOSITIVI MOBILI. ANALIZZEREMO UN ESEMPIO DI NOKIA PER IMPARARE 
COME LE NOSTRE APPLICAZIONI POSSANO INTERAGIRE FRA LORO 




in 




REQUISITI 



U c++ 



t 



L'SDK della Nokia per il 
Symbian serie 60. 
Una connessione 
Bluetooth su PC ed un 
cellulare provvisto di 
connessione Bluetooth 
o di due telefoni con 
sistema operativo 
Symbian. 



Tempo di realizzazione 



00000 



In questo articolo affronteremo la problematica 
riguardante l'invio e la ricezione di dati, attraver- 
so il protocollo Bluetooth con il sistema operati- 
vo per telefonia mobile, Symbian. Spiegheremo co- 
me effettuare una semplice trasmissione dati utiliz- 
zando il protocollo OBEX. La scelta dell'OBEX deri- 
va dal fatto che è facilmente adattabile anche al tra- 
sferimento tra un device mobile ed un PC. 
L'esempio utilizzato in questo articolo, è basato su 
quello fornito insieme al Symbian SDK, dal colosso 
Svedese Nokia, e precisamente il Btobjectexchange. 
Questo perché si tratta di un esempio molto didatti- 
co che esaurisce a fondo tutte le problematiche 
relative allo scambio dati con bluetooth. Il primo 
passo consisterà dunque nello scaricare l'SDK adat- 
to al vostro cellulare. Potete farlo all'indirizzo 
http://www.forum.nokia.com/. La nostra applicazio- 
ne dovrà sostanzialmente seguire questa sequenza 
logica: 

• Ricerca di periferiche bluetooth nel raggio d'a- 
zione del telefonino 

• Connessione alla periferica con cui vogliamo 
scambiare i dati 

• Instanziazione dei vari componenti che per- 
mettono la comunicazione 

• Invio del classico messaggio "Hello World" da 
un telefono all'altro. 

In tutto questo, al di là dei vari sistemi che servono 
per ricercare, connettere, far comunicare i vari siste- 
mi, il protocollo di trasporto che si occuperà fisica- 
mente di trasferire i dati da un telefono all'altro sarà 
l'Obex. 



IL PROTOCOLO OBEX 

Questo particolare standard, fornisce le funzioni 
indispensabili per trasferire interi oggetti o chunks 
di dati (interi blocchi di dati binary),da un device 
all'altro. Si tratta di un protocollo utilizzato non solo 
per la comunicazione BlueTooth ma anche con altri 
mezzi di trasporto, ad esempio iRDA, ovvero il tra- 



B 




Scella Devices 



Fig.l: Sequence Diagram di un'applicazione OBEX 

sferimento dati con gli infrarossi. Il sistema operati- 
vo Symbian supporta pienamente Obex e le API che 
lo gestiscono sono inglobate in 5 classi definite nel 
file di inclusione "obex.h": 

• TObexBluetoothProtocolInfo 

• TObexConnectlnfo 

• MObexServerNotify 

• CObexClient 

• CObexServer 

La classe TObexBluetoothProtocolInfo estende la 
classe TobexProtocolInfo. Come già detto OBEX può 
essere utilizzato con un gran numero di layer fisici 
di trasporto, iRDA piuttosto che Bluetooth per 
esempio. Per ciascuno di questi layer fisici abbiamo 
bisogno di una classe specifica derivata da Tobex- 
ProtocolInfo, nel nostro caso ovviamente, utilizzere- 
mo TObexBluetoothProtocolInfo. La sua interfaccia 
pubblica completa è la seguente: 

class TObexBluetoothProtocolInfo : public 

TObexProtocolInfo 

{ public: 

TRfcommSockAddr iAddr; 

TBuf<60> iTransport; // dalla classe 
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TObexProtocolInfo 



}; 



La classe TobexBluetoothProtocolInfo eredita da To- 
bexProtocolInfo un oggetto di tipo iTransport che 
conterrà un nome che indica il protocollo di traspor- 
to da utilizzare: RFCOMM per OBEX, irTyniTP per 
iRDA, e la estende con un oggetto di tipo Trfcomm- 
SockAddr che conterrà l'indicazione sulla porta o sul 
canale di comunicazione da usare in una connessio- 
ne con il device remoto. La classe TObexConnectlnfo 
contiene informazioni relative alla versione del- 
l' Obex, e altri dati che possono essere utili per avere 
informazioni generiche sui pacchetti. Ne riportiamo 
la costruzione per completezza 



class TObexConnectlnfo 


{ 


public: 


inline TObexConnectInfo(); 


inline TUint8 VersionMajor() const; 


inline TUint8 VersionMinor() const; 




}; 



La classe MObexServerNotify implementa tutte le 
funzioni necessarie a gestire gli eventi che possono 
occorrere durante la comunicazione. Ad esempio 
avverte l'applicazione client in caso di fallimento 
della connessione, oppure quando viene richiesta 
una nuova connessione, o ancora gestisce l'evento 
relativo all'arrivo del primo pacchetto valido e così 
via. Il codice che la implementa è il seguente 



class MObexServerNotify 



{ friend class CObexServer; 



private: 



virtual void ErrorIndication(TInt aError) =0; 
virtual void TransportUpIndication() =0; 
virtual void TransportDownIndication() =0; 
virtual TInt ObexConnectIndication(const 

TObexConnectInfo& aRemotelnfo, 
const TDesC8& alnfo) =0; 
virtual void ObexDisconnectIndication(const 

TDesC8& alnfo) =0; 

virtual CObexBufObject* PutRequestIndication() =0; 
virtual TInt PutPacketIndication() =0; 
virtual TInt PutCompleteIndication() =0; 
virtual CObexBufObject* GetRequestIndication( 

CObexBaseObject *aRequiredObject) =0; 
virtual TInt GetPacketIndication() =0; 
virtual TInt GetCompleteIndication() =0; 
virtual TInt SetPathIndication(const 

CObex: :TSetPathInfo& aPathlnfo, 
const TDesC8& alnfo) =0; 
virtual void AbortlndicationQ =0; }; 



Una breve descrizione degli eventi gestiti è la se- 
guente: 



Object Ex change 
Protocol (I 



Telephony Control 
Protocol (TCS) 



Service Disccvery 
Protocol (SDP) 



RFCOMM 
Logicai Link Control and Adaptiation Protocol (L2CAP) 



Link Manager Protocol (LMP) 



Baseband [Link Controller (LC)] 



Fig.2: Il protocollo OBEX 

• Errorlndication - viene eseguito quando si 
verifica un errore che costringe la connessione 
Obex ad essere terminata. Non vengono presi in 
considerazione errori che non terminano la con- 
nessione. Il suo valore di ritorno è un intero che 
è definito nella lista codici errore del Symbian. 

• TransportUpIndication - viene chiamata dal 
sistema operativo, quando un'applicazione 
Client richiede la connessione ad un Server. 
Questo però non indica che una sessione OBEX 
sia realmente iniziata, ma semplicemente che 
una connessione è stata richiesta. 

• TransportDownlndication - viene chiamata 
dal sistema operativo, quando una delle due 
parti termina la connessione 

• ObexConnectlndication - Il sistema operativo 
chiama questa funzione quando viene stabilita 
una connessione OBEX. All'interno di ObexCon- 
nectlndication viene mantenuto il parametro 
aRemotelnfo contiene le informazioni relative 
alla versione di OBEX utilizzata dalla macchina 
client che ha richiesto la connessione. 

• ObexDisconnectlndication - Questa funzione 
è chiamata quando una connessione OBEX ter- 
mina correttamente. Non viene richiamata 
quando l'applicazione client si disconnette ina- 
spettatamente. 

• PutRequestlndication - Viene chiamata quan- 
do viene ricevuto il primo pacchetto valido. Tut- 
tavia questa funziona non effettua alcuna opera- 
zione di parsing del pacchetto. Semplicemente 
indica che un pacchetto valido è stato ricevuto, a 
questo punto si può decidere cosa il sistema 
operativo ne deve fare. Il valore restituito da que- 
sta funzione sarà un oggetto CobexBufObject de- 
rivato da CobexBaseObject che fornirà tutte le in- 
dicazioni sul come eventualmente scrivere il da- 
to ricevuto in un file. 

• PutPacketlndications - Questa funzione se- 
gue sempre una PutRequestlndication e contie- 
ne informazioni sulla ricezione del pacchetto. 
Può essere utilizzata ad esempio per fornire 
un'indicazione sullo stato delle operazioni. 

• PutCompletelndication - Quando questa fun- 
zione è chiamata, l'applicazione sarà sicura di 
aver ricevuto tutti i pachetti OBEX inviati dal de- 
vice remoto. In caso la connessione si interrom- 
pesse o vada in un qualsiasi errore, questa fun- 




DOVE TROVARE 
L'ESEMPIO 

L'esempio a cui ci 
riferiamo, può essere 
trovato, una volta 
installato l'SDK, al 
seguente path: 



< Directory di 

installazione>\7.0s 

\Series60\series60Ex 

\BTObjectExchange\ 
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IDE 
CONSIGLIATI 

Il C++ Builder X 

versione Mobile 1.5, 

contiene componenti 

non visuali per il 

collegamento e il 

trasferimento tramite 

protocollo Bluetooth. 



zione non verrà chiamata. 

• GetRequestlndication - Questa funzione vie- 
ne eseguita sull'applicazione Server quando 
l'applicazione Client ne richiee un particolare 
oggetto. 

• GetPacketlndication - Una volta iniziata la tra- 
smissione mediante il protocollo OBEX, questa 
funzione verrà chiamata ad ogni pacchetto in- 
viato. 

• GetCompletelndication - Questa funzione 
viene chiamata quando la trasmissione dati è 
completata, in modo da permettere all'applica- 
zione Client di effettuare la deallocazione di tut- 
te le azioni. 

• Abortlndication - Questa funzione viene chia- 
mata quando il device Client ha interrotto la tra- 
smissione in modo controllato. 

Finita questa lunga introduzione teorica siamo 
pronti per passare alla pratica. Vediamo come utiliz- 
zare le informazioni fin qui acquisite per realizzare i 
nostri scopi 



LA RICERCA 
DEI DISPOSITIVI 

Il Symbian offre, per la ricerca dei devices disponibi- 
li, due metodologie principali: 

1 . Il Client istanzia una richiesta di identificazione; 
in questo modo può rendersi conto di quanti 
dispositivi fisici sono disponibili nel raggio di 
azione delle tecnologie scelte (Bluetooth, iRDA) 

2. Il Client utilizza l'interfaccia del device Blue- 
tooth (Bluetooth Device Selection UI). In questo 
caso è un vero e proprio Plug-in che si occupa di 
interrogare tutti i dispositivi presenti. Dopo aver 
rilevato le risposte, le mostra all'utente in un 
Dialog Box e successivamente sarà poi selezio- 
nato il device desiderato. 




Fig.3: Architettura del Symbian 

In questo articolo, ci occuperemo del secondo me- 
todo sia perché è quello utlizzato dall'esempio cita- 
to nell'introduzione, sia perché lo riteniamo quello 
più semplice e produttivo. La "Device Selection UI" è 
un Plug-in per la classe RNotifier la quale ne per- 
mette l'utilizzo di vari tipi predisposti dal sistema 




Fig. 4: Schema del Bluetooth 

operativo. Ora, supponiamo che stiate utilizzando 
l'applicazione "Rubrica" e che da questa applicazio- 
ne vogliate attivare la ricerca dei dispositivi blue- 
tooth presenti nel vostro raggio d'azione. Sarebbe 
l'applicazione "Rubrica" a dover implementare la 
dialog box per la visualizzazione dei dispositivi per- 
ché questa possa comparire al di sopra dell'interfac- 
cia principale. Questo è ovviamente scomodo, di 
fatto ogni applicazione dovrebbe contenere una de- 
finizione della dialog box se si volesse fare in modo 
che essa apparisse sempre in primo piano rispetto 
all'applicazione che l'ha chiamata. Il problema vie- 
ne risolto facendo in modo che l'applicazione 
"Client" instanzi una richiesta ad un Thread Server 
che gira in background che si occupa sia di recupe- 
rare la lista dei dispositivi presenti sia di costruire la 
dialog box e proiettarlo in primo piano rispetto 
all'applicazione Client che ha instanziato la richie- 
sta. Questo thread viene denominato "Notifier 
Server". La classe che consente la connessione ad un 
"Notifier Server" è la Rnotifier. Un esempio di come 
viene utilizzata la classe Rnotifier per connettersi al 
Thread, e instanziare la richiesta di creazione della 
dialog box con tutti i dispositivi trovati è presente nel 
metodo CBTDiscoverer::SelectDeviceL contenuto nel 
sorgente btdiscover.cpp presente nell'SDK della No- 
kia. Il primo passo è connettersi al Thread che gira in 
background, per farlo possiamo usare 

RNotifier not; 

User: : LeaveIfError(not.Connect()); 

Una volta connessi, viene inizializzato il plugin per 
la selezione dei device tramite un oggeto di tipo 
TBTDeviceSelectionParamsPckg. 

TBTDeviceSelectionParamsPckg selectionFilter; 

Questo oggetto contiene un'istanza della classe 
TBTDeviceSelectionParams. Inizialmente questa 
classe è riempita e quindi inizializzata con valori di 
default. 

TRequestStatus status; 

RNotifier è progettata per usare un Active Object per 
mandare al processo Client, una notifica quando 
l'utente seleziona un Item. La RNotifier è chiamata 
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per mostrare il Dialog di selezione dei dispositivi 
Bluetooth. Tale DialogBox, che si andrà successiva- 
mente a creare, mostrerà all'utente la lista dei dispo- 
sitivi Bluetooth attivi all'interno della rete locale Pi- 
coNet. A questo punto, la classe RNotifier esegue il 
codice per raggiungere tutti i dispositivi presenti. 
Nella chiamata alla funzione principale, il primo 
parametro sarà il TRequestStatus. Il secondo è una 
costante intera rappresentante il Dialog della sele- 
zione dei dispositivi bluetooth. Il terzo parametro è 
il Selection Filters e successivamente l'ultimo para- 
metro è il parametro di risposta contenente il dispo- 
sitivo Bluetooth scelto dall'utente nel DialogBox. 

not.Startl\lotifierAndGetResponse( status, 

KDeviceSelectionNotifierllid, selectionFilter, 
aResponse ); 

Poiché il processo di selezione è asincrono, cioè si 
attende che l'utente scelga il dispositivo dal Dialog 
Box, l'applicazione Client dovrà utilizzare la funzio- 
ne WaitForRequest per mettere in pausa il Thread 
dell'applicazione stessa fino a quando YRNofitier 
non avrà terminato il suo lavoro. In questo modo 
l'utente dovrà necessariamente fare la scelta per il 
dispositivo nel Dialog di selezione, dato che l'appli- 
cazione si fermerà fino a quando la scelta non av- 
verrà. Questo come detto, mediante il metodo Wait- 
ForRequest 

User: :WaitForRequest(status); 

La variabile Status, è utilizzata anche per determina- 
re l'esito di ritorno dall'esecuzione dell' RNotifier, in 
particolare ecco come controllare gli stati ed i codici 
di errore: 



return success; 



> 



LA CLASSI COBEXCLIEIUT 
E COBEXSERVER 

Queste classi fanno sì che l'applicazione Client co- 
munichi con l'OBEX Server, trasmettendogli o rice- 
vendo dati. L'esempio è riportato nell'interfaccia 
pubblica della COBexClient, della quale ne vediamo 
una parte del codice: 



class CObexClient : public CObex 


{ 


public: 






IMPORT 


_C ~CObexClient(); IMPORT_C static 

CObexClient* Newl(TObexProtocolInfo& 
aObexProtocolInfoPtr) ; 




IMPORT, 


_C void Connect(TRequestStatus& aStatus); 




IMPORT 


_C void Put(CObexBaseObject& aObject, 

TRequestStatus& aStatus); 




IMPORT 


_C void Get(CObexBaseObject& aObject, 

TRequestStatus& aStatus); 




IMPORT 


_C void Abort(); 




}; 



Affinché l'applicazione Client possa connettersi con 
un device server, dovrà, una volta creato un CObex- 
Client, conoscerne l'indirizzo specificandolo insie- 
me al protocollo da usare per la connessione. Tutte 
le informazioni, sono contenute nell'oggetto TObex- 
BluetoothProtocolInfo, visto in precedenza. Il Client, 
una volta ottenuta l'istanza della classe OBEX, potrà 
connettersi con il device OBEX remoto, e potrà 
richiedere o mandare un oggetto OBEX. Tutto ciò 




if (status. Int() == KErrNone) 


{ if (aResponse().IsValidDevicel\lame()) 


{ success = ETrue; } 


else 


{ iReporter.Error(_L("Failed to connect")); 


}} 


else 


{ iReporter.Error(_L("No device selected")); 


} 



L'applicazione Client ha finito con l'oggetto RNoti- 
fier e quindi, procediamo alla sua deallocazione. Per 
far questo, utilizziamo i metodi della RNotifier per 
deallocare sia il DialogBox, sia chiudere la connes- 
sione con il Server. Il tutto avverrà se il Server della 
RNotifier non ha nessun' altra connessione in atto, 
liberandone così tutte le risorse. 

not.CancelNotifier(KDeviceSelectionNotifierUid); 



not.Close(); 



La funzione a questo punto, ritorna il valore 



FRAMEWORK AGGIUNTIVI 



In aiuto allo sviluppatore di appli- 
cazioni Bluetooth, vi è un progetto 
che semplifica la realizazzione di 
applicazioni che sfruttano tale pro- 
tocollo. Una delle più affermate è 
senza alcun dubbio il Framework 
Cobain. Il Cobain fornisce tutte le 
API di cui necessita un'applicazione 
Bluetooth per Symbian. Ecco un 
sorgente di esempio per l'invio di 
un file tramite le Cobain API: 

Il create the API facade 
CCobainLayer *cobain = 

CCobainLayer: : NewL(); 
// fetch Bluetooth driver (Cobain will 

support other carriers too) 
MNetworkDriver *driver = cobain-> 

GetDriverL(EBIuetooth); 



// fetch peers synchronously - for demo 
// purposes, normally we'd use 
// asynchronous, of course 
TPeerList *peerlist = driver-> 

GetPeersL(0xl23456); 



// connect to the first peer found 
CNetworkPeer *peer = (*peerlist)[0]; 



RCobainSocket *socket = 



peer-> 
ConnectLQ; 



// send some data 



_LIT8(KData, "hello, world!"); 
socket->Sendl_(&KData); 



// dose & cleanup 



socket->Close(); 



delete driver; 



delete cobain; 
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I TUOI APPUNTI 



sarà possibile utilizzando le tre funzioni asincrone, 
ConnectQ, GetQ, PutO. L'operazione, o meglio la tra- 
smissione, potrà essere interrotta mediante la fun- 
zione Aborto. Il CObexServer fa in modo che un'ap- 
plicazione Client, estenda la disponibilità dei servizi 
OBEX, ad altri device. 

class CObexServer : public CObex 

i 

public: 

IMPORT_C static CObexServer* Newl( 

TObexProtocolInfo& aObexProtocolInfoPtr) ; 



IMPORT_C ~CObexServer(); 



IMPORT_C TInt Start(MObexServerNotify* aOwner); 



IMPORT_C void Stop(); 



inline TBool IsStartedQ; 



inline TOperation CurrentOperationQ const; 



}; 



Come per la classe CObexClient, quando allochia- 
mo la classe CObexServer, l'applicazione Client 
deve fornire un oggetto TObexProtocolInfo, che 
specificherà al server, tutte le informazioni dette di 
"ascolto". Queste informazioni includono il proto- 
collo da utilizzare, la porta, oppure quando si svi- 
luppano applicazioni Bluetooth come in questo 
caso, il canale su cui il server rimane in ascolto. 
Una volta che l'oggetto del Server è stato creato, il 
Server potrà partire. Per far ciò, si utilizza la fun- 
zione Storto che, una volta chiamata, obbligherà il 
Client a dare un'istanza della classe MObexSer- 
verNotify che fa parte anch'essa delle classi dette 
Observer. Il sistema operativo ritornerà tutti gli 
eventi rilevanti attraverso la classe CObexServer. Il 
Server potrà essere fermato, utilizzando la funzio- 
ne StopO;. 

Le funzioni ISStarted e CurrentOperation, control- 
leranno invece lo stato del Server. 



L'ESEMPIO 

BTObjectExchange 
DI NOKIA 

Come detto nella nostra introduzione, per poter 
capire bene l'utilizzo dello standard Bluetooth 
mediante V OBEX Protocol, ci riferiremo all'esem- 
pio fornito dalla Nokia con l'SDK della Serie 60. 
L'esempio è il BTObjectExcange Example. 
Le impostazioni che servono ad un CObexServer 
per una trasmissione tramite connessione Blue- 
tooth, sono pressoché identiche per qualsiasi 
altra connessione che si avvale di un altro proto- 
collo. Tutti i parametri delle impostazioni, deri- 
vano dal protocollo RFCOMM mediante l'utilizzo 
delle Bluetooth Sockets API, di cui anche l'OBEX 
si avvale. 



IMPOSTIAMO IL SERVER 

Le impostazioni dell' OBEX, vengono definite 
nella funzione AvailableServerChannelL, questa 
funzione è presente nel file sorgente ObjectEx- 
changeServer.cpp, dell'esempio BTObjectExchan- 
geExample. Nella stessa classe, troviamo la fun- 
zione InitialiseServerLO che è parte dell' OBEX 
Server e che permette di impostare la porta di 
"ascolto" e quindi di far partire il server. 

Void CobectExchangeServer: : InitialiseServerLO 

{■■■ 

// Cerca la porta di attesa dati 
TInt channel = AvailableServerChannell_(); 

Una volta ottenuto il canale, l'applicazione prowe- 
derà al settaggio di tutte le impostazioni di sicurezza 
del protocollo Bluetooth. Questo avviene mediante 
l'utilizzo della funzione SetSecurityChannellO;. 
Successivamente, per far partire effettivamente il 
server, viene creato l'oggetto TObexBluetoothProto- 
collnfo ed inizializzato impostandone il canale con 
le informazioni ottenute in precedenza. 
Inoltre, viene impostato il nome del protocollo 
richiesto, mediante una stringa che verrà utilizzata 
per specificarne il nome. In questo caso, la stringa è 
KServerTransportName: 

TObexBluetoothProtocolInfo obexProtocolInfo; 
obexProtocolInfo.iTransport.Copy(KServerTransportName); 
obexProtocolInfo. iAddr.SetPort(channel); 

Creato l'oggetto TObexBluetoothProtocolInfo, il CO- 
BexServer può essere istanziato e successivamente 
potrà esere avviato: 

iObexServer = CobexServer: :NewL( 

obexProtocolInfo); 

L'avvio del server, viene effettuato mediante la fri- 
zione StartO;: 

iObexServer->Start(this); 

iAdvertiser->StartAdvertisingl_(channel); 

iAdvertiser->UpdateAvailabilityl(ETrue); 



> 



Adesso dobbiamo impostare il Client e cioè, il CO- 
bexClient. Le impostazioni del Client sono le stes- 
se per qualsiasi applicazione OBEX. La principale 
differenza è data da come la classe TObexBlue- 
toothProtocolInfo viene impostata. La maggior 
parte delle informazioni, si ottengono in fase di 
ricerca del device, logicamente sempre con l'uti- 
lizzo dello standard Bluetooth e questo accade 
anche su applicazioni a basso livello RFCOMM di 
cui il protocollo OBEX, come detto prima, si awa- 
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le. Per motivi di spazio editoriali, abbiamo dovuto 
purtroppo tralasciare la spiegazione su come cer- 
care un device con connessione Bluetooth attiva 
(il Device Discovery), potrete però avvalervi degli 
esempi forniti con l'SDK della Nokia e soprattutto 
con l'esempio che stiamo utilizzando, dove è con- 
tenuto tutto il codice necessario per il Device 
Discovery. La costruzione del CObexClient, in rife- 
rimento al protocollo Bluetooth, avviene median- 
te la funzione ConnectToServerL ed è reperibile nel 
sorgente ObjectExchangeClient. cpp. 
La su citata funzione, è parte della classe CObject- 
ExchangeClient, come possiamo osservare nella 
linea di codice seguente: 

void CobjectExchangeClient: :ConnectToServerl_() 



IMPOSTIAMO IL CLIENT 

Il seguente codice invece si occuperà della creazione 
e del settaggio del Client, che dovrà effettuare la con- 
nessione al Server: 



TObexBluetoothProtocolInfo protocol Info; 
protocolInfo.iTransport.Copy(KServerTransportName); 
protocolInfo.iAddr.SetBTAddr(iServiceSearcher-> 

BTDevAddrQ); 

protocolInfo.iAddr.SetPort(iServiceSearcher->Port()); 



Una volta impostato e creato il Client, dovremo con- 
netterlo: 



if (iCIient) 


{ delete iCIient; 


iCIient = NULL; } 


iCIient = CObexClient: 


:Newl_(protocolInfo); 


iClient->Connect(iStatus); 


SetActive(); 



INVIARE E RICEVERE 
UN OBEX OBJECT 

Per far si che il Client invìi un oggetto OBEX, dobbia- 
mo logicamente crearlo. L'esempio ci viene in aiuto 
anche in questo, mediante la funzione 



vo invìi soltanto l'insieme di informazioni di intesta- 
zione. Nel nostro caso, l'informazione di intestazio- 
ne includerà il solo messaggio che l'applicazione 
Client deve inviare al Server, quindi il famosissimo 
messaggio "Hello World". 

iCurrObject = CObexNullObject::NewL(); 

JCurrObject->SetNameL(L("Hello World")); 

} 



Creato l'oggetto, l'invio del messaggio avviene me- 
diante la chiamata alla funzione PutQ: 

void CObjectExchangeClient: :SendMessagel_() 

{ if (iState != EWaitingToSend) 

{ User::l_eave(KErrDisconnected); } 
else if (IsActive()) 

{ User::Leave(KErrInUse); } 

iClient->Put(*iCurrObject, iStatus); 
SetActive(); 
} 



Per la ricezione, non viene fatto altro che salvare il 
Log di ricezione dati. Questo si può ottenere sapen- 
do principalmente che quando il CObexServer rice- 
ve le informazioni, avvisa l'applicazione Client tra- 
mite le funzioni, come spiegato all'inizio di questo 
articolo, dette Observer e definite nella classe 
MObexServerNotify. Quando l'oggetto e quindi i dati 
sono stati ricevuti, la funzione PutCompletelndica- 
tion è innescata. In questa funzione sono immagaz- 
zinati il nome ed i dati che il Server estrapolerà: 

TInt CObjectExchangeServer: : PutCompleteIndication() 
{ iLog.LogL(iObexBufObject->Name()); 

return KErrNone; 
} 

Una volta ricevuto il tutto, potremo provvedere allo 
spegnimento del server, per l'applicazione Server e 
del client per l'applicazione Client, logicamente se 
non avremo bisogno più né del Server, né del Client. 
Questo potremo farlo solo quando avremo discon- 
nesso il Client dal Server tramite la funzione Discon- 
nectO; della classe CObexClient. Successivamente, a 
sconnessione avvenuta, potremo anche cancellare 
l'oggetto CObexClient. 





GLOSSARIO 



Bluetooth 

Protocollo di trasferi- 
mento ad onde radio. 

OBEX Protocol 

Object Exchange 
Protocol. 

PayLoad 

Riferimento di un pac- 
chetto, frame o altra 
unità per la trasmissio- 
ne dati. 

RFCOMM 

Serial Port Emulation 



CObjectExchangeClient: :Constructl_: 
void CObjectExchangeClient: :Constructl_() 
{ 



La trasmissione dell'oggetto OBEX, consiste in due 
parti principali: Un set di Headers e una serie di dati 
veri e propri, detti PayLoad. Creando poi l'oggetto 
CObexNullObject, fa in modo che il sistema operati- 



CONCLUSIONI 

Abbiamo visto quanto l'utilizzo del protocollo OBEX 
in ambiente Symbian, sia utile e soprattutto produt- 
tivo. Questo protocollo ci permetterà di creare appli- 
cazioni che possano interagire con Devices di qual- 
siasi genere, a patto che supportino lo standard 
Bluetooth o l'iRDA o il trasferimento dati via seriale. 

Marcello Scala 
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L'ANNOTAZIONE DI UN'IMMAGINE CONSISTE NELL'EVIDENZIARE RIQUADRI DELLA STES- 
SA A CUI ASSOCIARE UNA BREVE DESCRIZIONE. QUESTO ARTICOLO ILLUSTRA 
COME CREARE UN COMPONENTE SWING DOTATO DI QUESTA FUNZIONALITÀ. 
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Lo scopo di questo articolo è creare un'appli- 
cazione che ci consenta di modificare delle 
foto, applicandovi dei segni di evidenzia- 
zione che ne mettano in rilievo particolari aree. 
Ad ogni riquadro di evidenziazione sarà possibile 
associare una descrizione. In Figura 1 è presente 
un esempio: sull'immagine di un tramonto citta- 
dino sono stati evidenziati tre punti. Da sinistra, 
un traliccio, delle case, ed una parte di cielo illu- 
minato in modo particolare. Ovviamente, la pre- 
senza di una etichetta ne riduce la leggibilità da 
parte dell'utente, anche se è possibile scegliere 
livelli diversi di trasparenza. Si noti che il ritaglio è 
evidenziato da un riquadro giallo trasparente, in 
modo da non coprire la parte di immagine relativa, 
che invece traspare. L'annotazione è invece scritta 
in bianco, utilizzando un font di dimensioni ridotte. 
Tutti questi aspetti grafici, con la relativa realizza- 
zione, saranno descritti in seguito. 




Fig.l: II programma in azione visualizza una immagine 
annotata 



COME FUNZIONERÀ 
IL PROGRAMMA? 

Quando l'applicazione verrà avviata, l'immagine 
sarà priva di annotazioni e di qualunque segno di 
evidenziazione. Cliccando sull'immagine sarà pos- 
sibile disegnare un riquadro che contrassegnerà la 
parte evidenziata. Inizialmente il riquadro sarà di 




Fig.2: All'inizio dell'esecuzione non sono presenti 
annotazioni 

colore bianco trasparente. Una volta delimitato un 
riquadro sarà possibile premere il tasto INVIO; que- 
sto evento, intercettato dal software, comporta la 
presentazione di una finestra di dialogo per la digi- 
tazione della descrizione da associare al ritaglio. 
Una volta confermata la descrizione, il ritaglio viene 
aggiunto all'immagine. 



SIAMO PRONTI 
PER INIZIARE 

Vediamo come realizzare queste funzionalità par- 
tendo dalla classe principale dell'applicazione, 
quella che contiene il metodo mainQ. La parte di 
codice più interessante riguarderà il costruttore: 

• per prima cosa verrà caricata l'immagine di pro- 
va, contenuta nel file DSC_0080.jpg, utilizzando 
ìeAPIImagelO; 

• poi verrà creato il pannello che gestice le imma" 
gini annotate; _ 

• verrà creato un JTabbedPane, utile per inserire 
un gestore di eventi di accesso alla tastiera. Que- 
sto elemento serve ad intercettare il tasto INVIO, 
per invocare la funzionalità di aggiunta di una 
annotazione. Questo gestore di evento è di tipo 
KeyListener. 

• Il pannello AnnotablelmagePanel viene inserito 
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nel JTabbedPane, che a sua volta viene inserito in 
una finestra di tipo JFrame, che viene poi visua- 
lizzata. 




Fig.3: L'applicazione in esecuzione 

Il codice sorgente completo della classe è il seguente: 



fraine. setVisible(true); 


} 


/** 


* @param args 


* @throws IOException 


*/ 


public static void main(String[] args) throws 

IOException { 


new Main(); 


} 


} 





RAPHICS O GRAPHICS2D 



L'oggetto Graphics appartiene 
alle API AWT e rappresenta un 
generico contesto grafico su cui è 
possibile disegnare testo, linee, 
cerchi, riquadri ed altro. 



Con l'introduzione di Java2, è sta- 
to aggiunto l'oggetto 
Graphics2D, che supporta funzio- 
nalità più potenti per la grafica 
bidimensionale. 



* Main 



package it.edmaster.ioprogrammo. annotazione; 



import java. awt.event.KeyAdapter; 



import java.awt.event.KeyEvent; 



import java. awt.image.Bufferedlmage; 



import java. io. IOException; 



import java. net.URL; 



import javax.imageio.ImagelO; 



import javax.swing.JFrame; 



import javax.swing.JTabbedPane; 



public class Main { 



public Main() throws IOException { 



//carica l'immagine di prova 



-•URL uri = getClass().getResource (7DSC_0080.jpg"); 
Bufferedlmage image = ImagelO.read(url); 
//crea il pannello di annotazione immagini 
-•final AnnotablelmagePanel annotablelmage 

Panel = new AnnotablelmagePanel(image); 
//inserisce l'immagine all'interno di un 
//pannello su cui viene inserita la gestione 
//della pressionedei tasti 
JTabbedPane pane = new JTabbedPane(); 
pane.add( annotablelmagePanel, "Annotazione" ); 
pane.addKeyl_istener( new KeyAdapter() { 
public void keyPressed(KeyEvent e) { 

if (e.getKeyCode() == KeyEvent.VK_ENTER) { 



IL PANNELLO IMMAGINI 

La classe di base è dunque abbastanza banale. 
Infatti, tutte le funzionalità sono raccolte nella clas- 
se AnnotablelmagePanel Vediamone il codice: 



AnnotablelmagePanel 



package it.edmaster.ioprogrammo. annotazione; 



e.consume(); 



annotable ImagePanel.editClipQ; 



}); 



//crea una finestra a cui associa il pannello 



//creato al passo precedente 



JFrame fraine = new JFrameQ; 



frame.getContentPane().add( pane ); 



frame.packQ; 



import java.awt.AlphaComposite; 



import java.awt.Color; 



import java.awt.Component; 



import java.awt.Composite; 



import java. awt. Font; 



import java.awt.FontMetrics; 



import java.awt.Graphics; 



import java.awt.Graphics2D; 



import java. awt. Image; 



import java. awt. Point; 



import java.awt.Rectangle; 



import java.awt.Shape; 



import java. awt.event.MouseAdapter; 



import java. awt. event.MouseEvent; 



import java. awt. event.MouseMotionListener; 



import java.util.ArrayList; 



import java.util.Iterator; 



import java. util. List; 



import javax. swing. Bo rd e r Factory; 



import javax. swing. Imagelcon; 



import javax. swing JLabel; 



import javax. swing JOptionPane; 



import javax. swing JPanel; 



import javax. swing. SwingUtilities; 



* Pannello che implementa immagini annotabili. 

Ciascuna annotazione 




GLOSSARIO 



LA CLASSE 
COMPOSITE 

Composite è una classe 
di AWT che permette di 
definire numerose 
funzionalità di fusione 
tra il tratto di disegno 
e lo sfondo. La classe 
concreta AlphaCompo- 
site agisce sul canale 
alfa (trasparenza). 
Un valore alfa di 1.0 
significa "completa- 
mente opaco". 
I valori possibili sono 
inclusi tra l'intervallo 
0.0 e 1.0. 
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INFORMAZIONI 
SUI FONT 

L'oggetto FontMetrics 

permette di conoscere 

tutti i dettagli 

numerici di un 

particolare font. 

La funzionalità più 

banale che viene 

offerta è quella di 

calcolare l'occupazione 

di spazio di una 

stringa, se disegnata 

con un particolare 

font, ma questa classe 

dispone di numerosi 

altri metodi per 

conoscere tutte le 

caratteristiche 

dimensionali di ciascun 

carattere del font. 




* è identificata da un riquadro, a cui è associata 

una descrizione. 

* Ciascun riquadro è rappresentato da un oggetto 

di tipo <code>Clipping</code>. 

* 

* @author max 

*/ 

public class AnnotablelmagePanel extends JPanel { 
/** immagine da visualizzare */ 



private Image image; 



/** dimensione bordo interno */ 



private final int borderSize = 20; 



/** etichetta utilizzata per visualizzare 

l'immagine */ 



private JLabel internalLabel; 



/** punto iniziale di trascinamento */ 



private Point initialPoint; 



/** indica che è in corso un'operazione di 

trascinamento */ 



private boolean dragging = false; 



/** punto finale di trascinamento */ 

private Point endPoint; 

/** elenco dei ritagli associati all'immagine */ 

private List clippings = new Arrayl_ist(); 

/** oggetto Composite utilizzato per disegnare 

riquadri in trasparenza */ 

private Composite composite = 
AlphaComposite.getInstance( 

AlphaComposite.SRC_OVER, 0.2f); 



Il costruttore inizializza il pannello e chiama il 
metodo B Q, per creare gli elementi del- 



l'interfaccia utente: 



* Crea un pannello annotabile 



ram image 



public AnnotableImagePanel(Image image) 



{ 



superQ; 



this. image = image; 



//ritaglio di prova 



//clippings.add(Clipping.create(297, 147, 97, 31, 
//"raggi di luce che vengono prodotti dal 
//tramonto inquinato della città di Bollate")); 



> createUI(); 



L METODO S wing Utilities. Ii\ivokeLater() 



Il codice presentato nell'articolo 
ha fatto uso del metodo 
SwingUtilities. In vokeLa ter(), 
permette di invocare un blocco 
di codice, formalizzato come 
implementazione dell'interfaccia 
Runnable, solo al termine 



dell'esaurimento di tutti gli 
eventi nella coda AWT. In questo 
modo si è sicuri che il proprio 
codice venga eseguito solo al 
termine di tutte le operazioni di 
aggiornamento dell'interfaccia 
utente. 



J 



Nel metodo createUIQ per prima cosa viene crea- 
to un oggetto E 3 per cui viene creata 

una classe anonima che ridefinisce il metodo 
paintlconO- Nella ridefinizione, viene invocato il 
metodo drawClippingsO, che si occupa di visua- 
lizzare i ritagli associati all'immagine. Questo 
comporta che ad ogni visualizzazione di questa 
immagine vengano ridisegnati anche i ritagli: 



* crea l'interfaccia utente 



private void createUIQ 



{ 



-# Imagelcon imagelcon = new Imagelcon(image) 

{ 

public synchronized void paintIcon( Component 

argO, Graphics argl, int arg2, int arg3) 

{ 

super.paintlcon(arg0, argl, arg2, arg3); 



drawClippingsO; 



}; 



MImagelcon così creata viene utilizzata per crea- 
re una JLabel, un modo standard in Swing per 
visualizzare una immagine a video. L'etichetta 
viene poi inserita nel pannello e viene impostato 
un bordo, per rendere più gradevole l'aspetto del 
pannello: 

internalLabel = new Jl_abel( imagelcon ); 
add( internalLabel ); 
setBorder( 
BorderFactory.createEmptyBorder( 
borderSize, borderSize, 
borderSize, borderSize) 

); 

A questo punto è necessario creare alcuni gesto- 
ri di evento, in modo da poter intercettare i movi- 
menti del mouse e gestire così la definizione dei 
ritagli. Il primo gestore è MouseMotionListener, 
che intercetta l'evento mouseDraggedQ. Il fun- 
zionamento è il seguente: se non è in corso un'o- 
perazione di dragging (il valore del flag omonimo 
è false), la attiva, memorizzando il punto iniziale 
da cui è partito il mouse. Poi imposta il punto 
finale, e chiama il metodo trackMoveQ, che 
visualizza il riquadro individuato da questi due 
punti. L'evento mouseClickedQ permette di inter- 
cettare clic del pulsante, che indica la volontà 
dell'utente di cancellare un ritaglio attivo. 
L'evento mouseReleasedQ indica invece il rilascio 
di un pulsante, il che indica la fine di un'opera- 
zione di disegno del ritaglio: 

//traccia il movimento del mouse salvando il punto 
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//iniziale di trascinamento 



addMouseMotionListener(new MouseMotionl_istener() { 
public void mouseDragged(MouseEvent e) 



{ 



if (Idragging) 



{ 



initialPoint = e.getPointQ; 



dragging = true; 



} 



endPoint = e.getPointQ; 



trackMoveQ; 



e.consumeO; 



} 



public void mouseMoved(MouseEvent e) { } 



}); 



addMouseListener( new MouseAdapterQ 



{ 



public void mouseClicked(MouseEvent e) 



{ 



deleteMoveQ; 



e.consumeO; 



} 



public void mouseReleased(MouseEvent e) 



{ 



dragging = false; 



e.consumeO; 



}); 



CREARE UHI RITAGLIO 

I metodi coinvolti nella definizione di un nuovo 
ritaglio sono trackMoveQ e editClipQ- Il primo 
disegna un riquadro a partire dal punto iniziale 
fino a quello finale, ottenuto estraendo le coordi- 
nate dai campi initialPoint e endPoint. Poi viene 
estratto il contesto grafico del componente che 
contiene l'immagine, viene impostato il colore 
bianco e viene disegnato il bordo del ritaglio. Poi 
viene impostato il Composite che indica al siste- 
ma di disegnare con una trasparenza del 20% e 
viene riempito il ritaglio: 



* disegna il ritaglio in fase di definizione 



private void trackMove() 



{ 



//ridisegna l'immagine 



internalLabel.repaintO; 



final Rectangle b = internalLabel.getBounds(); 
Swinglltilities.invokeLater( new Runnable() 



{ 



public void run() 



int x = (int)(initialPoint.getX() - 


b.getXO); 




int y = (int)(initialPoint.getY() - 


b.getYO); 




int width=(int)(endPoint.getX() 


- b.getXO) - 


x; 


int height=(int)(endPoint.getY() 


- b.getYO) 


-y; 


Graphics2D g = (Graphics2D 

)intemalLabel.getGraphics(); 


g.setColor(Color.WHITE); 


g.drawRect(x, y, width, height); 


g.setComposite( composite ); 


g.fillRect(x+l, y+1, width-1, height-1); 


} 


}); 


} 



Una volta che l'utente ha selezionato un ritaglio, 
può aggiungerlo all'immagine. Questa operazio- 
ne viene avviata dalla pressione del tasto INVIO, 
che viene intercettato dal KeyListener impostato 
sul JTabbedPane. Questo invoca il metodo 
editClipQ, che presenta una finestra di dialogo in 
cui l'utente deve digitare la descrizione da asso- 
ciare al ritaglio. Una volta inserita viene creato 
un oggetto Clipping, che rappresenta un singolo 
ritaglio. Questo oggetto contiene le coordinate 
del riquadro da evidenziare e la descrizione da 
associare. 

Dispone inoltre di metodi statici createQ che ven- 
gono utilizzati per creare oggetti di questo tipo. 
Al termine dell'operazione il ritaglio attivo viene 
cancellato: 



* presenta la finestra per la digitazione 



* della descrizione del ritaglio 



public void editClipO 



{ 



Point pi = initialPoint; 



Point p2 = endPoint; 



String m = JOptionPane.showInputDialog( 

this, "Digita la descrizione da associare 
a questo ritaglio"); 



if (m != nuli && m.lengthQ > 0) 



{ 



//crea un ritaglio e lo aggiunge all'elenco 



CONVERSIONI DI TIPO 





CARICARE 
UN'IMMAGINE 

Il modo più facile, a 
partire da Java 1.4, per 
caricare una immagine 
in memoria è utilizzare 
la classe ImagelO, 
invocando il metodo 
read(): 



Bufferedlmage image = 
ImagelO. read(new File( 
"fotografia.jpg" )); 

L'oggetto ritornato è di 
tipo Bufferedlmage, 
che descrive un tipo 
particolare di 
immagine il cui buffer 
dati è in qualche modo 
accessibile. 



La classe ImagelO si può 
utilizzare anche per effettuare 
conversioni di tipo. Ad esempio, 
per cambiare il formato di una 
immagine in formato /peg nel 
formato png. In questo caso è 
sufficiente caricare l'immagine e 
poi salvarla con il metodo 
writeQ, specificando il formato 
richiesto: 



Bufferedlmage image = ImagelO. read( 
new File("forografia.jpg" )) 



File outputFile = new File( 
"fotografia.png") 



ImagelO. write( 

image, "png", outputFile ) 

Attenzione: la piattaforma Java 
supporta solo GIF, JPEG, PNG, BMP e 
pochi altri formati. 
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IL PACKAGE 
SWING 

Un altro modo facile 

per caricare una 

immagine in Java è 

utilizzare la classe 

Imagelcon, presente 

nel package Swing. Per 

esempio: 

Imagelcon ic = new 
ImagelconC'icona.jpeg"); 

Per estrarre 

l'immagine è poi 

possibile utilizzare il 

metodo getlmageQ: 

Image image = 

ic. getlmageQ; 



Clipping e = Clipping.create( pi, p2, m ); 

clippings.add(c); 

repaintQ; 



} 



initialPoint = nuli; 



DISEGNARE I RITAGLI 

Proseguendo nella discussione della classe An- 
notablelmagePanel, verranno affrontati ora i 
metodi di disegno dei ritagli. Il metodo draw- 
ClippingsO si occupa di disegnare tutti i ritagli 
associati all'immagine, estraendo il contesto 
Graphics dall'etichetta, i suoi limiti (bounds) e 
chiamando il metodo drawClippings(): 



private void drawClippingsQ { 



if (internalLabel != nuli) { 



Graphics2D g = (Graphics2D) 

internalLabel. getGraphics(); 
Rectangle b = internalLabel. getBoundsQ; 



drawClippings(g, b); 



} 



Il metodo effettivo di disegno è il seguente. Come 
si nota dal codice, viene impostata una iterazio- 
ne sulla lista dei ritagli dell'immagine. 
L'impostazione del codice è simile al metodo 
trackMoveO, con la differenza che il colore del 
ritaglio è giallo, e non bianco, come la selezione 
attiva. Inoltre il ritaglio ha una descrizione, diver- 
samente dalla selezione. 

I passaggi svolti dal metodo draw ClippingsQ so- 
no i seguenti: 

• determina le coordinate del ritaglio; 

• disegna il bordo; 

• disegna il contenuto (con effetto trasparen- 
za), salvando il precedente oggetto Composi- 
te; 

• crea un font più piccolo di quello di default 
per disegnare le descrizioni; 

• imposta il colore bianco ed il Composite origi- 
nale; 

• salva il ritaglio Swing attivo dell'immagine; 

• imposta il font e disegna il testo; 

• ripristina il vecchio ritaglio. 

II codice è il seguente: 



; disegna sull'immagine i ritagli evidenziati 



ram g 



private void drawClippings(Graphics2D g, Rectangle b) 



if (g != nuli && b != nuli && clippings != nuli) 



{ 



for( Iterator it = clippings. iteratorQ; 



it.hasNext(); ) 



Clipping e = (Clipping)it.next(); 



Rectangle r = c.getBoundsQ; 



//determina le coordinate del ritaglio 



int x = (int)(r.getX() - b.getXQ); 



int y = (int)(r.getY() - b.getYQ); 



int width = (int)r.getWidthQ; 



int height = (int)r.getHeightQ; 



//disegna il bordo del riquadro 



g.setColor( Color.YELLOW ); 



g.drawRect(x, y, width, height); 



//disegna il contenuto del riquadro, 



//utilizzando la trasparenza 



Composite oldComposite = g.getCompositeQ; 



g.setComposite( composite ); 



g.fillRect(x+l, y+1, width-1, height-1); 



//crea un font più picccolo 



//per le descrizioni 



Font font = g.getFontQ; 



font = font.deriveFont(8f); 



//imposta il colore bianco ed il 



//composite di default 



g.setColor( Color.WHITE ); 



g.setComposite( oldComposite ); 



//imposta la regione di clipping sullo 
//spazio individuato dal ritaglio 



Shape oldClip = g.getClipQ; 



g.setClip(x+l, y+1, width-1, height-1); 
//imposta il font da utilizzare e disegna 



//la descrizione 



g.setFont(font); 



drawMultiLineString(g, c.getDescription(), x, y, 

width, height); 



//ripristina il vecchio ritaglio 



g.setClip(old Clip); 



} 



Le operazioni di salvataggio dei vecchi Composi- 
te e Clip dell'immagine sono indispensabili, in 
quanto il disegno dell'annotazione successiva 
sarebbe intralciata dalle impostazioni di ritaglio 
e trasparenza impostate per l'annotazione prece- 
dente. 

Un altro aspetto degno di nota è il metodo draw- 
MultiLineStringQ, creato appositamente per 
disegnare testo su più linee. La logica di funzio- 
namento di questo metodo è semplice: calcola la 
dimensione di ciascun carattere, fino a che non 
viene raggiunta la dimensione massima in pixel 
del ritaglio corrente. A questo punto il metodo 
disegna i caratteri fino ad ora individuati e poi va 
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a capo, ripetendo l'operazione fino a che ci sono 
caratteri nella stringa, oppure fino a che non 
viene esaurito lo spazio disponibile in verticale: 



disegna una stringa su più righe 



ram g 
ram text 



ram y 



* @param width 



@param height 



labazione e la giustificazione del testo: queste 
funzionalità lo avrebbero reso decisamente più 
complesso. Un approccio alternativo sarebbe 
stato utilizzare una JLabel per ciascun ritaglio, 
utilizzando solamente componenti Swing ad alto 
livello, evitando del tutto l'oggetto Graphics e le 
sue funzionalità. La classe si conclude con il 
metodo per cancellare il ritaglio in corso: 

/** 

* cancella la selezione attiva 

*/ 




private void drawMultil_ineString( Graphics g, 

String text, int x, int y, int width, int height ) 



{ 



FontMetrics fm = g.getFontMetricsQ; 



char[] chars = text.toCharArrayQ; 



int i = 0; 



int start = 0; 



int line = 1; 



int lineWidth = 0; 



//bordo di due pixel 



int border = 3; 



width -= border * 2 + 2; 



//cicla per tutti i caratteri della stringa 

while (i < chars. length) 



{ 



int cw = fm.charWidth ( chars[i] ); 



lineWidth += cw; 



if (lineWidth >= width || i == chars. length-1) 



{ 



//disegna fino al carattere i-1 



int limit = i-1-start; 



//se sono a fine stringa disegno tutto 



if (i == chars. length-1) 



{ 



limit = i-start+1; 



} 



//verifico di non superare l'altezza 



//massima 



int dy = (line*fm.getAscent()); 



if (border+dy > height) 



{ 



break; 



} 



//crea la sottostringa e la scrive 



String s = new String( chars, start, limit); 
g.drawString(s, x+border, y+border+dy); 
start = i-I; 



line++; 



lineWidth = 0; 



i+ + ; 



Ovviamente questo metodo non supporta la sil- 



private void deleteMoveQ 



{ 



initialPoint = nuli; 



endPoint = nuli; 



internalLabel.repaintQ; 



CONCLUSIONI 

In questo articolo sono state illustrate alcune 
tecniche per operare con la grafica a basso livel- 
lo in Java, utilizzando sempre come punto di 
partenza componenti visuali Swing. 
Particolarmente interessanti sono le funziona- 
lità per disegnare elementi grafici utilizzando la 
trasparenza e l'oggetto FontMetrics, che permet- 
te di conoscere l'occupazione esatta in pixel di 
caratteri e stringhe, funzionalità che ha consen- 
tito di realizzare un semplice disegno di testo 
multilinea. 

Massimiliano Bigatti 




UALE FORMATO 



I formati grafici supportati da 
Java sono limitati. 
Per conoscere quali codec sono 
presenti nel sistema è possibile 
utilizzare sempre la classe 
ImagelO, che dispone di alcuni 
metodi per conoscere i formati 
supportati, sia in lettura che in 
scrittura. 

L'esempio di codice seguente 
ne stampa l'elenco utilizzando 
un metodo di supporto per 
stampare un vettore: 

String [] readers = 

ImagelO.getReaderFormatNamesQ; 
print( "Lettori (informali)", readers ); 

String[] mimeReaders = 

ImagelO. getReaderMIMETypes(); 
print( "Lettori (MIME)", mimeReaders ); } 



String [] writers = 

ImagelO. getWriterFormatNames(); 
print( "Scrittori (informali)", writers ); 
String[] mimeWriters = 

ImagelO. getWriterMIMETypes(); 
print( "Scrittori (MIME)", mimeWriters ); 
private void print( 

String header, String[] elements) 



System.out.println( header ); 
System. out.println( "= = = = = = 



="); 



for(int i=0; i<elements. length; i++) 



{ 



System.out.println( elements[i] ); 



System.out.println( "= 



="); 
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IO PROGRAMMO BY EXAMPLE 

IMPARA A PROGRAMMARE IN MODO PRATICO E DIVERTENTE, CON GLI ESEMPI PASSO PASSO 
CHE TI GUIDANO ALLA COSTRUZIONE DEL CODICE 



I COME POSSO 

lìH'IJWIM l REALIZZARE UN 
EQj^^^H WEBSERVICE? pag. 49 

Con Visual Studio 2005 ci vengono in aiuto 
alcuni wizard molto utili, con Java e PHP 
vedremo che le difficoltà sono maggiori solo 
in fase di test e deploy 






m 



... 



H— COME POSSO 
CONTROLLARE LO STATO DEL TASTO 
CAPS LOCK? pag. 52 

Per controllare il tasto CAPS LOCK il frame- 
work .NET mette a disposizione il metodo 
IsKeyLocked. Facciamone un esempio in 
Visual Basic .NET 



FUNZIONI? 



I COME POSSO VERIFICARE 
I CHE UN WEB SERVICE 

pag. 52 



Normalmente è possibile connettersi diret- 
tamente all'indirizzo del WS ed ottenere 
informazioni sul WSDL, l'output però dipen- 
de molto da come il servizio è stato realiz- 
zato 




I COME SI INSTALLA UN WEB 
SERVICE IN MS? pag. 54 

Anche in questo caso è sufficiente copiare 
i file che lo compongono nella directory 
che ospiterà il servizio. Tuttavia in US la 
directory in questione deve essere confi- 
gurata come applicazione. Per far questo 
si può procedere in due modi 

RICAVARE INFORMAZIONI 
SUI TIPI pag. 56 

Ecco come è possibile ottenere il tipo di un 
oggetto direttamente a runtume 



I COME POSSO UTILIZZARE 



EfflEM UN WEB SERVICES? 



pag. 56 

/ diversi metodi dipendono dai linguaggi, in 
tutti i casi la base rimane sempre SOAP 



WSDL? 



I CHE COSA VUOL DIRE 

pag. 58 



I QUALI SONO I COMANDI 
BASE DI MYSQL DA LINEA 
DI COMANDO? pag. 58 

Una rapida carrellata sui principali metodi 
per creare, eliminare i db, e importare ed 
esportare dati in formato sql. 



COME ELENCARE I FONT 
DISPONIBILI? pag. 59 

Sfruttiamo alcune classi di Java per avere in- 
formazioni sui font installati nel sistema 



VUOI INVIARE UN ESEMPIO? 

Se sei un programmatore esperto ed 
hai risolto un problema, puoi 
aiutare gli altri pubblicando il tuo 
codice. Proponi i tuoi esempi 
scrivendo a 



ioprogrammo@edmaster.it 



Come contattarci? 

Alla nostra redazione arriva spesso un considerevole 
numero di email riguardante temi specifici. Per con- 
sentirci di rispondere velocemente e in modo adegua- 
to alle vostre domande abbiamo elaborato una FAQ - 
Frequently Ask Question - o risposte alle domande 
frequenti in italiano, di modo che possiate indirizzare 
le vostre richieste in modo mirato. 

Problemi sugli 
abbonamenti 

Se la tua domanda ha a che fare con una delle seguen- 
ti: 

• Vorrei abbonarmi alla rivista, che devo fare? 

• Sono un abbonato e non ho ricevuto la rivista, a 
chi devo rivolgermi? 

• Sono abbonato ma la posta non mi consegna 
regolarmente la rivista, a chi devo rivolgermi? 

Contatta abbonamenti@edmaster.it specificando 
che sei interessato a ioProgrammo. Lascia il tuo indi- 
rizzo email e indica il numero dal quale vorresti far 
partire l'abbonamento. Verrai contattato al più presto. 
Oppure puoi chiamare lo 02 831212 



Problemi sugli allegati 

Se riscontri un problema del tipo: 

• Ho acquistato ioProgrammo ed il Cdrom al suo 
interno non funziona. Chi me lo sostituisce? 

• Ho acquistato ioProgrammo ma non ho trovato il 
cd/dvd all'interno, come posso ottenerlo? 

• Vorrei avere alcuni arretrati di ioProgrammo co- 
me faccio? 

Contatta servizioclienti@edmaster.it 

Non dimenticare di specificare il numero di copertina 
di ioProgrammo e la versione: con libro o senza libro. 
Oppure telefona allo 02 831212 

Assistenza tecnica 

Se il tuo problema è un problema di programmazione 
del tipo: 

• Come faccio a mandare una mail da PHP? 

• Come si instanzia una variabile in c++? 

• Come faccio a creare una pagina ASP.NET 

o un qualunque altro tipo di problema relativo a 



tecniche di programmazione, esplicita la tua 
domanda sul nostro forum: http://forum.iopro- 
grammo.it, uno dei nostri esperti ti risponderà. Le 
domande più interessanti saranno anche pubblica- 
te in questa rubrica. 

Problemi sul codice 
alFinterno del CD 

Se la tua domanda è la seguente 

• Non ho trovato il codice relativo all'articolo all'in- 
terno del ed 

Consulta la nostra sezione download all'indirizzo 
http://cdrom.ioprogrammo.it, nei rari casi in cui il 
codice collegato ad un articolo non sia presente nel 
cdrom, senza dubbio verrà reso disponibile sul nostro 
sito. 



Idee e suggerimenti 



Se sei un programmatore esperto e vuoi proporti 
come articolista per ioProgrammo, oppure se hai sug- 
gerimenti su come migliorare la rivista, se vuoi inviar- 
ci un trucco suggerendolo per la rubrica tips & tricks 
invia una email a 
ioprogrammo@edmaster.it 
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COME POSSO REALIZZARE 
UN WEB SERVICE? 

CON VISUAL STUDIO 2005 CI VENGONO IN AIUTO ALCUNI WIZARD MOLTO UTILI, CON PHP 
VEDREMO CHE LE DIFFICOLTÀ SONO MAGGIORI SOLO IN FASE DI TEST E DEPLOY 



I FACCIAMOLO 
IN ASP.NET CON C# 

1 Iniziamo con il creare un nuovo sito tramite il 
menu File /New Web Site. 



Open Website... 
Open File.,. 



Website Euild Debug Tools nd Community Help 

Qrl+N [ -i il 

— H^- - 4à& i 

App_Code/Ser vice.cs | 



Close 

dose Project 



Ctrl+S 



3ave Appjlode/Serace.c 
3a - ,'f.v Cl J'r.'i'-i .-... ' . 
5ave AH Ctrl+5hift+5 

empiate,., 



|Q Page Setup.,. 
^ Print... 



Recent Files 
Recent Projects 



query(string strSql) 



[ Web He t ho ci] 

public query (string strSql) { 

SqlConnection conn = neti SqlConnection ( ) 
string strcon = B"server=JÀCOXP\SQLEXPRE; 

miString = strcon; 
conn.OpenO; 

oDataSed = ( ) ; 

iwC unatìaiid = ( 

myCortìmand CorartianciType .Text 

myAdaptec = 
myAtìapter , TabieHappiiigs . Acid ( 
my Adaptec - Se : ectComaiand = tiiyCotraviand; 
myAdaptec. Fi 11 (oDacai 
coan.Cloae(ì; 



2 Dalla dialog box che segue scegliamo "Web 
Services" come tipologia del progetto e più in 
basso selezioniamo il linguaggio C# 



Templates: 



Visual Studio installed templates 



£| ASP.NET Web Site 
^ Empty Web Site 

My Templates 



ASP.NET 



t3 5earc h Online Templates.. 






A Web site for crea eb services 



Location: 
Language: 



File System 



v C:\Documents and Settings\jac 



I Aggiungiamo il seguente spezzone di codice 



[WebMethod] 

public DataSet query(string strSql) 

{ 

SqlConnection conn = new SqlConnection(); 
string strcon = @"server= 

JACOXP\SQLEXPRESS;Initial Catalog = 
ioProg_DVD_4SQL;User ID=sa; PWD=sa" 
conn.ConnectionString = strcon; 



conn.OpenQ; 



DataSet oDataSed = new DataSetQ; 

SqlCommand myCommand = new 

SqlCommand("SELECT * FROM Description 
where Applicazione Like '%" + strSql 
+ "%"', conn); 
myCommand.CommandType = 

CommandType.Text; 
SqlDataAdapter myAdapter = 

new SqlDataAdapter(); 
myAdapter. TableMappings.Add( 

"Table", "TableO"); 

myAdapter.SelectCommand = myCommand; 
myAdapter. Fill(oDataSed); 
conn.Close(); 
return oDataSed; 
} 



4 Compiliamo il tutto e copiamo il risultante file 
asmx sul webserver dove vogliamo che il nostro 
servizio venga esposto. 

COME FUNZIONA? 

Lo starter kit ci mette a disposizione lo scheletro di 
un web service che non fa altro che restituire al 
client la stringa helloworld. Dal codice si capisce 
subito che per esporre un metodo bisogna farlo 
precedere dall'etichetta [WebMethod] è esatta- 
mente quello che abbiamo fatto noi con il metodo 
"query". 

Il nostro metodo si connette ad un database sql 
server 2005 e invia a questo una query composta 
da una parte fissa e da una parte da aggiungere 
all'operator like. La parte variabile deve essere for- 
nita al web service dal client. Ad esempio se il 
client fornisse al web service il parametro "ioPro- 
grammo" verrebbero selezionate tutte le righe del- 
la tabella description che al loro interno hanno la 
parola "ioProgrammo". 

^^M FACCIAMO 

IN ASP.NET CON VISUAL BASIC 

I passi da eseguire nei punti uno e due riman- 
gono identici a quelli utilizzati per il progetto in 
linguaggio C#. Il codice da utilizzare invece è il 
seguente: 

<WebMethod()> 

Public Function query(ByVal strSql As String) 



VISUAL BASIC.NET 
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As DataSet 



Dim conn As SqlConnection = 

New SqlConnection() 
Dim strcon As String = 

"server=JACOXP\SQLEXPRESS;Initial 
Catalog = ioProg_DVD_4SQL;User ID=sa; 

PWD=sa" 



conn.ConnectionString = strcon 



conn.OpenQ 



Dim oDataSed As DataSet = New DataSet() 
Dim myCommand As SqlCommand = New 
SqlCommand("SELECT * FROM Description 
where Applicazione Like '%" & strSql & 
"%"', conn) 
myCommand. CommandType = 

CommandType.Text 
Dim myAdapter As SqlDataAdapter = 

New SqlDataAdapter() 
myAdapter. TableMappings.Add( 

"Description", "TableO") 
myAdapter.SelectCommand = myCommand 
myAdapter. Fill(oDataSed) 
conn.Close() 
Return oDataSed 



End Function 

^SFACCIAMOLO IN PHP 

1 Creiamo un file index.php all'interno di una 
sottodirectory del web server e come prima 
operazione sviluppiamo la funzione che si inter- 
faccerà al database 



function execQuery($strSql) 


{ 


$connessione = mysql_connect( 


"localhost", "root", "password" 


) or die("Connessione non 


riuscita: " . mysql_error()); 


mysql_select_db("ioprogrammo") or die( 


"Selezione del database non riuscita"); 



COSA È NUSOAP? 

Nusoap è una libreria opensource 
direttamente scaricabile all'indirizzo 
http://dietrich.ganx4.com/nusoap/ e che 
implementa un framework intermedio 
per l'accesso alle funzioni soap e di 
conseguenza per creare e usare web 
services in PHP. Non solo si tratta di 
una libreria affidabile, ma è 
praticamente l'unica che consente di 
generare automaticamente il wsdl. In 
PHP5 esistono una serie di funzioni 
interne per utilizzare i web services che 



risultano essere molto più veloci di 
quelle implementate in Nusoap, 
tuttavia rimangono ancora 
sufficientemente limitate per certi 
aspetti. Di fatto non consentono la 
generazione automatica del wsdl per 
tale motivo anche per chi usa PHP5 è 
consigliabile ancora adesso utilizzare 
Nusoap. In PHP4 il problema non si 
pone, di fatto non ci sono funzioni 
interne a PHP per interfacciarsi con i 
web services. 



/* Esecuzione di una query SQL */ 
$query = "SELECT * FROM file where 

Applicazione like '%$strSql%'"; 
$risultato = mysql_query($query) or die( 

"Query fallita: " . mysql_error() ); 

while ($riga = mysql_fetch_array( 

$risultato, MYSQL_ASSOC)) 

{ 



$columns[] = $riga; 



> 



/* Chiusura della connessione */ 



mysql_close($connessione); 



//return $columns[0]; 



return new soapval('returnytns:Idiot',$columns); 



i Includiamo il file nusoap.php 



require_once('nusoap.php'); 



3 Distanziamo il server e aggiungiamo un tipo 
che ci servirà per descrivere i valori di ritorno 
che devono essere contenuti nello schema XML 
Soap 



$server 


= new 


soap_server(); 




// Initia 


ize WSDL support 




$ns="http://localhost/~fabio/stock/services.php"; 


$server- 


>configureWSDL('services 


, $ns); 


$ serve r- 


>wsdl- 


>schemaTargetl\lamespace=$ns; 


$ serve r- 


>wsdl- 


>addComplexType("MyType", 


"complexType", 


"array", 


"ali", 


""/ 


array( " 


[D" => 










array("ID" => ' 


ID", 






"type" 


= > "xsd:string"), 






"Applicazione" 


= > array( 






"Applicazione" = 


= > "Applicazione", 






"type" 


= > "xsd:string"), 






"File" => arr 


ay("File" => 






"File", "type" 


= > "xsd:string"), 


"Sottotitolo" => array( 


"Sottotitolo" => "Sottotitolo", "type" 


= > "xsd:string"), 






"Descrizione" 


= > array( 






"Descrizione" 


= > "Descrizione", 






"type" 


= > "xsd:string"), 


"NumeroRivista" => array( 






'NumeroRivista" => 


"NumeroRivista", 






"type" 


= > "xsd:string"), 


"IDmc" => array("IDmc" 
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= > "IDmc", "type" 


= > "xsd:string"), 




"Dim" => 


array("Dim" => 




"Dim", "type" 


= > "xsd:string"), 




"posiz" => 


array( 


"posiz' 


= > "posiz", "type" 


= > "xsd:string"), 




"Link" => 


array("Link" => 




"Link", "type" 


= > "xsd:string"), 




"Evidenza' 


= > array( 


"Evidenza" => "Evidenza", "type" => 




"xsd:string"), "] 


ndispensabili" => 


array("Indispensabili" = 


> "Indispensabili", 




"type 


' => "xsd:string") 


) 




); 



4 Inseriamo le informazioni relative al protocollo 
di trasporto e agli altri dati che serviranno per la 
descrizione del WSDL 



$server->register('execQuery', // method name 
array('strSql' => 'xsd:string'), // input parameters 



array('return' => 'tns:Idiot'), 



// output parameters 



'urn:services', // namespace 



'urn:services#execQuery', // soapaction 



'rpc', // style 



'encoded', // use 

'Ritorna un array contenente i valori richiesti' 

// documentation 



Infine invochiamo il web services 



$HTTP_RAW_POST_DATA = isset( 

$HTTP_RAW_POST_DATA) ? 

$HTTP_RAW_POST_DATA : "; 

$server->service($HTTP_RAW_POST_DATA); 



COME POSSO CONTROLLARE LO STATO 
DEL TASTO CAPS LOCK? 



Per controllare il tasto CAPS LOCK il 
framework .NET mette a disposizione 
il metodo IsKeyLocked. 
Facciamone un esempio in Visual Basic 
.NET 



If Control. IsKeyLocked Then 



MessageBox.Show("CAPS LOCK Inserito", 
"", MessageBoxButtons.OK, _ 
MessageBoxIcon.Exclamation) 



Else 



MessageBox.Show("CAPS LOCK Non 

Inserito", "", MessageBoxButtons.OK, _ 
MessageBoxIcon.Exclamation) 

Endlf 



COME POSSO VERIFICARE CHE UN WEB 
SERVICE FUNZIONI? 

NORMALMENTE È POSSIBILE CONNETTERSI DIRETTAMENTE ALL'INDIRIZZO DEL WS 
ED OTTENERE INFORMAZIONI SUL WSDL, L'OUTPUT PERÒ DIPENDE MOLTO DA COME 
IL SERVIZIO È STATO REALIZZATO 



I FACCIAMOLO 
CON PHP & NUSOAP 

1 Aprite un normale browser e connettetevi al 
servizio Web. Ad esempio http://localhost 
/-vostrahome/servizio/nomeservizio.php. Supposto 
che il Web Service sia stato realizzato con PHP e 
Nusoap l'output sarà il seguente: 




La pagina web contiene un link al file WSDL e uno 
per uno i link ai metodi esposti dal webservices 

2 Clicchiamo sul link al wsdl e otteniamo il file 
wsdl in formato chiaramente leggibile. Si noti 



PHP & NUSOAP 



< —*j> 

SaiE«B.e*a- 

4atEcMda 



ACCkraM- «• 
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che non usando SOAP sarebbe piuttosto complica- 
to generare a mano il file in questione 

3 Clicchiamo su uno dei metodi esposti dal web- 
service ed otterremo un riferimento alla docu- 
mentazione relativa a quel particolare metodo. Si 
notino in particolare i parametri in input ed output 
relativi al metodo in questione 



Vtow the •■■ forthi |*rvl«. 

Clltk or» àn OPiri&nn n *™ W .1** 




IFACCIAMOLOCON.NET 

1 Anche i in questo caso è necessario collegarsi 
alla uri che espone il web service. Nel nostro 
esempio http:lllocaWiostlwebsiteSlservice.asmx. 




Esattamente come nel caso di PHP verrà mostrata 
una pagina che contiene i link ai metodi imple- 
mentati dal servizio 

2 Per ottenere la descrizione contenuta nel file 
WSDL questa volta è necessario utilizzare il link 
"service description" 




3 Cliccando sul link che riporta il nome di uno 
dei metodi si ottiene questa volta non solo una 
pagina con la descrizione dei parametri accettati in 
input e in output, ma anche una o più caselline di 
input che ci consentono di testare il servizio al di la 
di un normale client 




COME POSSO INSTALLARE UN WEB 
SERVICE IN US? 

ANCHE IN QUESTO CASO È SUFFICIENTE COPIARE I FILE CHE LO COMPONGONO 
NELLA DIRECTORY CHE OSPITERÀ IL SERVIZIO. TUTTAVIA IN MS LA DIRECTORY IN QUESTIONE 
DEVE ESSERE CONFIGURATA COME APPLICAZIONE. PER FAR QUESTO SI PUÒ PROCEDERE 
IN DUE MODI 



COME 

SI INSTALLA 

UN WEB 

SERVICE 

IN APACHE? 

È sufficiente copiare 
il file php e il reattivo 
nusoap.php nella direc- 
tory che esporrà 
il servizio. 



1 Creare una directory al di sotto della wwwroot 
di US. 

2 Portarsi in pannello di controllo /strumenti di 
amministrazione e avviare Internet Information 
Services. 

3 Nella finestra che compare selezionare la direc- 
tory in cui installare il web services e cliccare 
con il tasto destro del mouse, di seguito sulla voce 



proprietà. 
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Nella finestra delle proprietà cliccare su "crea 
1 applicazione" 




5 Portatevi nella la tabsheet "Asp.net" e nella 
casella a discesa che riguarda la versione di 
Asp.net installata selezionate quella relativa al fra- 
mework con cui avete sviluppato il Web Services 




ISP.net 



cWiA»,»»^^^^^ 



ti LUBil flMÉ-l I I 2 L 



A questo punto potete applicare tutte le modifiche 
e copiare i file nella directory opportuna. 

^SFACCIAMOLO CON 
UNA DIRECTORY VIRTUALE 

ILa differenza con il metodo precedentemente 
descritto consiste nel fatto che in questo caso la 
directory che conterrà i file sarà posizionata al di 
fuori della wwwroot. In questo caso portatevi nel 
web site principale, cliccate con il tasto destro e 
selezionate "nuova directory virtuale" 




2 Si awierà una procedura guidata. Al secondo 
punto vi verrà richiesto di inserire un alias per la 
vostra directory virtuale. Utilizzate un'etichetta 
significativa ad esempio il nome del vostro proget- 
to: stockQuotes 



E SE US RESTITUISCE ERRORE? 



Se avete installato MS dopo avere in- 
stallato Visual Studio Express Edition, 
è probabile che non siano stati creati 
gli utenti corretti per potere eseguire 
le applicazioni ASP.NET in Windows. 
Per risolvere il problema portatevi nel- 
la directory di installazione del f rame- 
work. Tipicamente C:\WINDOWS 



\Microsoft.NE7\Framework\v2. 0.50727 e 
digitate aspnet_regiis -/. 
Ovviamente sostituite al percorso indi- 
cato quello relativo alla vostra instal- 
lazione. Verranno automaticamente 
creati gli utenti necessari a far funzio- 
nare MS con ASP.NET 2.0 e il problema 
precedente sarà risolto 



- tu >:■*■■* p-«fcfn 



' - ■ ■ ■ 



~^n —j 



3 Nel passo successivo vi verrà chiesto di selezio- 
nare la directory fisica a cui la vostra directory 
virtuale è associata. Cercatela nell'albero delle 
directory tramite il tasto sfoglia 



Creazione guidata Di ectai ;.' virtuale 



Q >^ Disco locale (C:) 

E) (£) Documents and Settings 

Ipll final 
G (£| Inetpub 

(È) AdrminScripts 
E (£) iissamples 
IE3 Scripts 

P°> App_Code 
(£) App_Data 



S L 



— 



| 1024x768 [ 



Impostate i permessi per la nuova directory 
■selezionate almeno il permesso d'esecuzione 




5 La procedura termina qui. Potete settare l'in- 
stallazione di ASRNET ripartendo dallo step 5 
del metodo precedentemente 



E SE MORI 
HO US? 

Potete ugualmente 
provare il funzionamento 
del vostro Web Services se 
avete utilizzato Visual 
Studio 2005 Express. Il 
prodotto di Microsoft 
dispone infatti di un web 
server integrato. 
È sufficiente cliccare sul 
bottoncino "play" nella 
barra degli strumenti di 
Visual Web Developer e 
verrà lanciato un nuovo 
Web Server su una porta 
random della vostra 
macchina 
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RICAVARE INFORMAZIONI SUI TIPI 



Per conoscere a runtime l'oggetto 
Type per un particolare tipo è possi- 
bile ricorrere in C# all'operatore typeof. 

Type t=typeof(string); 
//restituisce System. Stri ng 

In Vb.NET l'operatore equivalente è 
GetType: 

Dim t as Type 
t=GetType(string) 

Se si vuole lo stesso risultato, ma per co- 
noscere il tipo di un'istanza o di 
un'espressione, è invece utilizzabile il me- 
todo GetType, ereditato dalla classe 
Object 



Type t=obj.GetType(); 

Oppure il metodo statico Type.GetType, 
con il nome completo sotto forma di 
stringa, che restituisce nuli (nothing in 
vb.net) se non riesce a risolvere il nome 
del tipo: 

t = Type.GetType("System.Int32") 

Esiste inVb.NET un operatore Typeof, da 
non confondere con il typeof di C#, e che 
si usa congiuntamente all'operatore is, 
formando un'espressione del tipo TypeOf 
expr is type: 

if(TypeOf i is Integer) 



End if 

L'operazione restituisce true se l'espres- 
sione è compatibile con il tipo specifica- 
to. Ad esempio sarebbe vera per una 
Form testandola con il tipo Control. 

If (TypeOf formi Is Control) Then 
Console. Write("forml è un Control") 
End If 

Per effettuare un test sulla compatibilità 
dei tipi in C# invece si usa il solo operato- 
re is: 

if(obj is Control) 

{ 

//obj è compatible con Control } 



COME POSSO UTILIZZARE UN WEB 
SERVICES? 

I DIVERSI METODI DIPENDONO DAI LINGUAGGI, IN TUTTI I CASI LA BASE RIMANE 
SEMPRE SOAP 



VISUAL BASIC.NET 



CACCIAMOLO CON PHP 

1 Prima di tutto includiamo la libreria nu- 
soap.php che contiene le varie classi che ci con- 
sentono di lavorare in modo semplificato con il 
webservices 

<?php 
require_once('nusoap.php'); 

2 Creiamo un istanza del client, e tramite il file 
wsdl informiamo l'istanza di quali sono i meto- 
di che il WS espone e della sua descrizione. Ovvia- 
mente il parametro passato al client corrisponde 
all'indirizzo del WS. Nel nostro caso il wsdl viene 
generato automaticamente dallo script, in altri po- 
tremmo avere bisogno di referenziare direttamente 
il file wsdl 

$client = new soapclient_n("http://localhost 

/~fabio/stock/services.php?wsdl", true); 

^ Controlliamo se ci sono eventuali errori 



$err = $client->getError(); 
if ($err) { 



echio '<h2>Errore ne costruttore</h2xpre>' 

. $err . '</pre>'; 



Richiamiamo il metodo esposto dal webservi- 
ces passandogli eventuali parametri sotto for- 



4 

ma di array 



$result2 = $client->call('execQuery', array( 

'strSql' => 'test')); 



1 controlliamo eventuali errori e stampiamoli 
' eventualmente a video 



if ($client->fault) { 



echio '<h2>Fault</h2xpre>'; 



echio '</pre>'; 



else { 



$err = $client->getError(); 



if ($err) { 



echio '<h2>Error</h2><pre>' . $err 



'</pre>'; 



' Se non ci sono errori stampiamo il risultato a 
'video 
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} else { 



// Display the result 



echo '<h2>Result</h2xpre>'i 



print_r($result2); 



echo '</pre>'; 



} 



I Se vogliamo possiamo stampare anche il debug 
delle comunicazioni avvenute fra client e server 



echo '<h2>Request</h2>'; 


echo '<pre>' . htmlspecialchars( 

$client->request, ENT_QUOTES) . 


'</pre>'; 


echo '<h2>Response</h2>'; 


echo '<pre>' . htmlspecialchars( 

$client->response, ENT_QUOTES) . 


'</pre>'; 


// Display the debug messages 


echo '<h2>Debug</h2>'; 


echo '<pre>' . htmlspecialchars( 

$client->debug_str, ENT_QUOTES) . 


'</pre>'; 


?> 



I FACCIAMOLO 
IN VISUAL BASIC.NET 

ISu una form trasciniamo una DataGridView, 
una TextBox e un bottone 






>j 





2 Clicchiamo nel solution explorer con il tasto 
destro sul nome del progetto, nel menu a tendi- 
na che ne risulta selezionamo "Add Web Reference" 
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This web service is using http://tempuri.org/ as its 
default namespace. 
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3 Nella dialog box che compare, indichiamo l'uri 
che espone il web services. Pochi secondi dopo 
ci comparirà la descrizione del wsdl e dei metodi 
esposti. Clicchiamo su Add Reference. Possiamo se 
vogliamo, cambiare il nome che comparirà come 
etichetta del WS 

4 Clicchiamo due volte sul bottone per gestire il 
codice relativo all'evento OnClick. Il codice da 
inserire è il seguente 

Private Sub Buttonl_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
Dim ws As New test. Service 
Dim ds As DataSet = ws.query( 

TextBox l.Text.ToString()) 
'DataGridViewl.DataSource = ds 
DataGridViewl.DataSource = ds.Tables("TableO") 
'DataGridViewl.DataMember = "TableO" 
DataGridViewl.Enabled = True 
DataGridViewl.Refresh() 
End Sub 
End Class 



I FACCIAMOLO IN C# 

IFino al punto 4 il procedimento rispecchia fe- 
delmente quello utilizzato da Visual Basic. Il 
codice di gestione diventa invece il seguente 

private void buttonl_Click(object sender, EventArgs e) 

i 

test. Service ws = new test.Service(); 

DataSet ds = new DataSet(); 

ds = ws.query(textBoxl.Text.ToString()); 

// DataGridViewl.DataSource = ds 

dataGridViewl.DataSource = ds.Tables["TableO"]; 

// DataGridViewl.DataMember = "TableO" 

dataGridViewl.Enabled = true; 

dataGridViewl.RefreshQ; 



Add Reference 






WindowisApp 

Mi My Project 
Web Refen 
#; test 
app.config 

_J Forml.vb 



eb References I 
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CHE COSA VUOL DIRE WSDL? 

NEI NOSTRI ESEMPI SUI WEB SERVICES CI SIAMO SPESSO RIFERITI A UN FILE WSDL 
COME QUELL'ELEMENTO CHE CONTIENE LA DESCRIZIONE DEL SERVIZIO. 
MA COSA È ESATTAMENTE E COME FUNZIONA? 



IWeb Services non sono il pri- 
mo tentativo di creare un pon- 
te di comunicazione fra elemen- 
ti installati in luoghi geografica- 
mente distanti, tuttavia hanno 
apportato una notevole dose di 
cambiamento proprio per la loro 
caratteristica di aggirare i limiti 
imposti dai linguaggi per diven- 
tare "Intercomunicanti" in modo 
del tutto indipendente dalla 
piattaforma di sviluppo e dal si- 
stema operativo. L'idea è sem- 
plice. Lo sviluppatore A crea un 
programma (un web service) e lo 
rende disponibile su un sito web. 
Lo sviluppatore B interroga quel 
sito web e senza avere cono- 
scenze di come è implementato 
il web services che c'è sotto ne 
usa le informazioni. Ad esempio 



il Web Service potrebbe restitui- 
re l'elenco delle città italiane 
con più di 50.000 abitanti. Al 
programmatore B non importa 
sapere con quale linguaggio sia 
stato sviluppato il Web Service o 
su che sistema operativo giri, 
importa solo il risultato. Per ot- 
tenere il risultato deve sapere 
solo quali metodi del web servi- 
ce invocare e niente altro. È pro- 
prio a questo che serve WSDL, si 
tratta di un formato standard 
per la descrizione formale di un 
Web Services. Ogni Web Service 
deve esporre il proprio file 
WSDL. Per la difficoltà di imple- 
mentazione del formato, tipica- 
mente il programmatore non 
scrive a mano il suo file WSDL 
ma si affida a framework come 



nusoap o asp.net ad esempio, 
che consentono la generazione 
dinamica del file WSDL. In que- 
sto modo interrogando il web 
service con un certo parametro, 
tipicamente ?WSDL si ottiene la 
sua descrizione formale, genera- 
ta automaticamente dal frame- 
work utilizzato per lo sviluppo. 
Se volete potete provare ad an- 
alizzare un file WSDL. 

<message name= 

"execQueryRequest"> 
<part name="strSql" type= 

"xsd:string"/> 

</message> 
<message name= 

"execQueryResponse"> 
<part na me =" return" type= 



"tns:MyType"/> 



</message> 

in questo caso viene indicato 
che il WS deve ricevere una 
stringa in ingresso e restituisce 
un output in formato MyType. 
Più avanti si può trovare la defi- 
nizione di MyType 

<xsd:complexType name= 

"MyType" > 



<xsd:all> 



<xsd:element name="ID" type= 
"xsd:string" ID="ID"/> 



<xsd:element name= 
"Applicazione" type="xsd:string" 
ID="ID" Applicazione= 
"Applicazione"/> 



</xsd:all> 



</xsd:complexType> 



QUALI SONO I COMANDI BASE 

DI MYSQL DA LINEA DI COMANDO? 

UNA RAPIDA CARRELLATA SUI PRINCIPALI METODI PER CREARE, ELIMINARE I DB, 
E IMPORTARE ED ESPORTARE DATI IN FORMATO SQL 



MYSQL 



Il comando principale per accedere a 
mysql è 



mysql -unomeutente -ppassword database 

se accedete come root potete evitare di selezionare 
il database, root è l'utente amministrativo a cui 
sono concessi i privilegi per eseguire ogni opera- 
zione sul db. 



i Per creare un nuovo database potete usare il 
i comando 



mysqladmin -unomeutente -ppassword create 

nomedatabase 

3 Per creare un nuovo utente che abbia accesso 
al database appena creato entrate in mysql 
come utente root e poi digitate 



identified by 'password'; 

Potete modificare il simbolo "*" con l'unica tabella 
a cui intendete concedere il permesso, e modificare 
"ali" con i privilegi che ritenete più opportuni 

4 Per eliminare un database potete usare il 
comando 

mysqladmin -unomeutente -ppassword drop database 

5 Per esportare un database in formato 
SQL 

mysqldump -unomeutente -ppassword database 

> nomefile 



Per importare un database dal formato 
' mysql 



grant ali privileges on database.* to utente 



mysql -unomeutente -ppassword database < nomefile 
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COME ELENCARE I FONT DISPONIBILI? 

SFRUTTIAMO ALCUNE CLASSI DI JAVA PER AVERE INFORMAZIONI SUI FONT INSTALLATI 
NEL SISTEMA 



Apriamo eclipse e scegliamo File/New 
Project 
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I Dalla dialog box successiva scegliamo "Java 
i Project" 
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i Diamo un nome significativo al progetto, ad 
* esempio "elencofont" e clicchiamo su finish 
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nome del progetto e scegliendo "New Class" 

5 Diamo un nome significativo alla classe ad 
esempio "ListFonts" e scegliamo di fare 
generare anche il main tramite l'apposito switch 
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6 Aggiungiamo in testa alla classe gli import che 
ci serviranno per recuperare le nostre informa- 
zioni 

import java.awt.GraphicsEnvironment; 

^ E modifichiamo il main in modo opportuno 

public static void main(String[] args) { 

ListFonts If = new ListFonts(); 
lf.printFonts(); } 

Non ci resta che scrivere il metodo 
printFonts 



8 



public void printFontsQ { 



GraphicsEnvironment gè = GraphicsEnvironment. 

getLocalGraphicsEnvironment(); 
String[] fonts = ge.getAvailableFontFamilyNames(); 
System. out.println("Numero di Fonts 

disponibili: " + fonts. length); 
System. out.println("Elenco dei Fonts disponibili:"); 



for(int i=0; i<fonts. length; i++) { 
System. out.println("\t" + fonts[i]); 



COME FUNZIONA? 

Tutto è demandato al metodo printFonts che in- 
stanzia un nuovo oggetto di classe GraphicsEnvi- 
ronment e utilizza il metodo getAvailableFontFami- 
lylMames() per riempire un array di stringhe che 
viene poi stampato con un classico ciclo di for. 
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ANTEPRIMA SUL 
NUOVO JAVA 6 SE 

MIGLIORATA L'INTEGRAZIONE CON IL DESKTOP DEL SISTEMA OPERATIVO DI RIFERIMENTO: 
È POSSIBILE IMPLEMENTARE IL COMPORTAMNETO DELLA BARRA DI STATO E GESTIRE 
L'AGGIUNTA DI ICONE CON MENU POPUP PERSONALIZZABILI 





SUL WEB 



DOVE SCARICARE 

LA JAVA SE 6 

BETA 

All'indirizzo 
http://java.sun.com/javase 
/6/download.jsp possia- 
mo effettuare il down- 
load gratuito della 
Java SE Development 
Kit (JDK) 6 Beta. 
Disponibile anche la 
Runtime Environment 
(JRE) 6 Beta che con- 
sente agli utenti finali 
di eseguire 
applicazioni Java. 



Gli sviluppatori di mezzo mondo non aveva- 
no ancora digerito per bene la versione 5 
della Standard Edition di Java, che già ci si 
trova a fare i conti con la 6, coincidente con la 1.6.0 
developer version. In realtà si tratta di una beta, 
nome in codice Mustang, ma la curiosità è tale e 
tanta da stuzzicare anche il developer più annoiato. 
Partendo con Y esplorazione della "beta six", non 
possiamo non apprezzare una considerevole atten- 
zione verso l'universo desktop. Ciò è rilevabile in 
primis dall'interfaccia utente e dall'integrazione 
con il sistema operativo di riferimento, e questa, a 
ben vedere, è una novità a dir poco rivoluzionaria, 
considerata la proverbiale ritrosia dei progettisti di 
casa Sun nel preoccuparsi di contaminazioni 
costruttive con l'ambiente circostante, probabil- 
mente per una attenzione quasi maniacale nonché 
esclusiva verso le proprie creazioni e una devozione 
esagerata verso la filosofia dell'essere piuttosto che 
per quella dell'apparire. I meriti di questo cambia- 
mento sono da ascrivere anzitutto al progetto 
JDesktop Integration Components (JDIC), che offre 
alle applicazioni Java l'accesso alle caratteristiche 
rilevabili dal desktop del sistema operativo in cui 
l'ambiente di sviluppo stesso si trova ad essere ospi- 
tato: questa operazione di incoraggiamento verso la 
collaborazione con le applicazioni desktop attive e 
maggiormente utilizzate, dal browser al client di 
posta, alla gestione risorse, alle utility per la stampa 
o la riproduzione multimediale, sarà sicuramente 
vista di buon grado da parte dell'utenza, oltre a rap- 
presentare un ottimo viatico per migliorare l'indice 
di gradimento verso Java ad opera dei più diffiden- 
ti. Non a caso, tra le new entry visibili con maggiore 
evidenza, c'è da segnalare la presenza di una fanta- 
stica API nuova di zecca: nientepopo dimeno che il 
package java.awt .Desktop, quello che, grazie ad 
appositi action events garantirà alle nuove applica- 
zioni realizzate in codice Java la piena integrazione 
con le desktop applications più comuni per la crea- 
zione e la modifica di file nei formati più popolari. 
Proseguendo, segnaliamo poi il supporto degli spla- 
sh screen, con la possibilità che questi informino 
l'utente circa l'avvio di un'applicazione. Da segnala- 



re anche i miglioramenti nelle Java Foundation 
Classes e nella gestione degli oggetti Swing, con 
maggiori integrazioni che semplificano il layout 
complessivo delle applicazioni e una personalizza- 
zione avanzata, udite udite, del drag and drop. 
Insomma, se pensiamo ai burrascosi rapporti con 
Windows, pare proprio che fra un po' la cosa potrà 
ritenersi acqua passata. Java sembra infatti viaggia- 
re verso una integrazione sempre più spinta con il 
sistema Microsoft, che la porterà fra non molto ad 
essere considerata, ci si passi il paragone, non più lo 
scomodo inquilino che crea sempre problemi, ma 
quello dal carattere un po' sui generis con cui però 
si può andare comunque d'accordo. 



GESTIAMO 

LA BARRA DI STATO 

Due presenze interessanti si trovano nel package 
java.awt: si tratta in particolare delle classi System- 
Tray e Traylcon, il cui compito è relativo alla gestio- 
ne della barra di stato che, in Windows come in altri 
ambienti, consente di raccogliere riferimenti a file, 
servizi ed applicazioni in attività: ebbene, attraver- 
so la gestione di azioni ed eventi, con un'applica- 
zione Java è possibile manipolare con il mouse gli 
oggetti che fanno parte della barra o che ruotano 
attorno ad essa, implementando operazioni di 
aggiunta, rimozione e modifica della caratteristiche 
relative a ciascuna voce. In particolare, un'istanza 
della classe SystemTray, propria per ciascuna appli- 
cazione, può contenere una o più istanze di oggetti 
Traylcons, ciascuna definita per mezzo di un'imma- 
gine, un menu popup ed un insieme di listener 
associati. Ciascuna istanza di un oggetto Traylcons 
potrà essere aggiunta alla barra (o meglio, all'istan- 
za che la definisce in astrazione Java) attraverso il 
metodo add(java.awt .Traylcon), così come potrà 
essere rimossa per mezzo del metodo speculare 
remove (j ava. awt.Traylcon). L'implementazione in 
codice impone che ciascuna applicazione Java pre- 
senti una singola istanza SystemTray che consenta 
all'applicazione stessa di interfacciarsi con la barra 
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interfacciarsi con la barra di stato del sistema per 
tutto il tempo in cui l'applicazione è attiva. L'istanza 
SystemTray può essere ottenuta attraverso il metodo 
getSystemTrayO, mentre un'applicazione non potrà 
creare la propria istanza della classe SystemTray 
L'accesso alla barra di stato del sistema avviene at- 
traverso una serie di istruzioni del tipo: 

Traylcon iconaBarra = nuli; 
if (SystemTray.isSupportedO) { 

// si apre l'if: la barra è supportata 

// restituisci l'istanza della barra 



// aggiorniamo l'immagine 



if (traylcon != nuli) { 



SystemTray barra 



SystemTray.getSystemTrayO; 



// adesso carichiamo un'immagine 



Image immagine = 

Toolkit.getDefaultToolkit.getImage(...); 
// ora creiamo un action listener per metterci 
// in ascolto dell'azione di default eseguita 



// sull'icona della barra 



Action Listener listener = new Actionl_istener() { 

public void actionPerformed(ActionEvent e) { 

// esegui l'azione di default dell'applicazione 



// -..} 



}; 



Se invece vogliamo popolare la barra con un menu 
popup, ed aggiungere icone personalizzate, scrive- 
remo: 

// creiamo un menu popup 

PopupMenu popup = new PopupMenu(); 

// creiamo una voce di menu per l'azione di default 

Menultem defaultltem = new Menultem(...); 

defaultltem.addActionListener(listener); 

popup. add(defaultltem); 

/// ... aggiungiamo altre voci costruiamo 

// una Traylcon 

traylcon = new TrayIcon(image, "Esempio ", popup); 

// impostiamo le proprietà corrette 

traylcon. addActionListener(listener); 

// aggiungiamo l'icona alla barra 

try{ 

tray.add(traylcon); 
} catch (AWTException e) { 

System.err.println(e);} 
} // si chiude l'if 
else { 

// la barra non è supportata: disabilitiamo 

// l'opzione barra nell'applicazione 

// o eseguiamo altre azioni 



} 



Possiamo addirittura gestire il cambiamento dello 
stato dell'applicazione 

// se lo stato dell'applicazione è cambiato 



traylcon. setlmage(updatedlmage); } 



GENERAZIONE... 
INTERATTIVA! 

Proseguendo, l'altro grande vantaggio della Stan- 
dard Edition 6 è legato al core, ossia a tutto ciò che 
ruota attorno al linguaggio e agli strumenti adopera- 
ti per gestirne le potenzialità. Guardiamo per esem- 
pio al compilatore: la nuova API Java Compiler ga- 
rantisce che il codice sorgente Java sia compilato 
all'interno di un'applicazione. Durante la compila- 
zione, l'applicazione ha accesso al contenuto infor- 
mativo elaborato in relazione alle librerie, compreso 
di eventuali warning, errori e altri messaggi che po- 
trebbero essere generati. A ben vedere, questa carat- 
teristica esprime un vantaggio da non sottovalutare: 
se infatti si prova a costruire lo strato di accesso ai 
dati di un'applicazione dOi cui si stava effettuando il 
build, il codice scritto genererà e compilerà le classi 
adoperate per accedere alle tabelle di database del- 
l'applicazione. Alla fine, avremo un file JAR che sarà 
generato, buildato e deployato come parte degli 
script Ant del sistema. E il fatto che le classi siano 
state compilate all'interno dell'applicazione fa della 
generazione del codice un processo interattivo: è 
possibile modificare e costruire le classi in maniera 
iterativa. . . pare poco? Per abilitare il Java scripting, 
la Standard Edition 6 supporta il framework JSR 223, 
che offre l'accesso del linguaggio di scripting alle 
porzioni più nascoste del linguaggio. In tal modo, è 
possibile localizzare gli engine di scripting e richia- 
marli per eseguire script a runtime. L'API Scripting 
consente di offrire il supporto Java per il linguaggio 
di scripting scelto, così come il Web Scripting 
Framework garantirà al codice script la generazione 
di contenuto Web all'interno di qualsiasi Servlet 
container. Per effettuare le operazioni di debugging, 
la piattaforma Java di riferimento (JPDA) è stata 
migliorata per intercettare eventuali deadlock e 
generare tracciati di stack per oggetti monitor even- 
tualmente bloccati. Inoltre, Java SE 6 garantisce che, 
per motivi di carattere diagnostico, gli agent si allac- 
cino ad una JVM in esecuzione. La presenza di un 
full stack trace nella eccezione java.lang.OutOfMe- 
mory e la conseguente generazione di un log di fatai 
error al riempimento dell'heap contribuisce a mi- 
gliorare la gestione della memoria, così come, sem- 
pre al riempimento dell'heap, una nuova opzione 
della virtual machine consente di eseguire un parti- 
colare script. 

Le novità sono ancora molte, avremo occasione di 
andare in profondità nel momento in cui la versione 
definitiva sarà rilasciata 

Luigi Caputo (luigi@edmaster.it) 




WEB SERVICES 

La presenza di alcune 
API fa sì che la nuova 
Java SE 6 supporti egre- 
giamente i Web servi- 
ces. L'API XML Digital 
Signatures garantisce 
Web services totalmen- 
te Java-based attraver- 
so l'implementazione di 
operazioni di crittogra- 
fia su dati in formato 
XML, così come l'API 
JAX-WS 2.0 ha aggiorna- 
to la libreria JAX-RPC 
Proseguendo, si segna- 
lano miglioramenti a 
Java-XML Binding 
(JAXB) 2.0, compresi il 
supporto dello schema 
XML e il class binding 
verso uno schema. 
Infine, l'API STaX 
(Streaming API for XML) 
offre un'API bidirezio- 
nale allo scopo di leg- 
gere e scrivere oggetti 
XML mediante uno 
stream di eventi, com- 
presa la capacità di by- 
passare le sezioni e di 
concentrarsi invece sul- 
le sottosezioni di docu- 
menti. 
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Office XP, RTF e OLE 



SCRIVI IN VISUAL BASIC 
LEGGI IN WORD 

COME UTILIZZARE IL CONTROLLO RICH TEXT BOX E INTERAGIRE CON IL FAMOSO FORMATO 
RTF. UN ESEMPIO IMPORTANTE CHE CI CONDUCE A POTERE STAMPARE UN DOCUMENTO 
OFFICE PARTENDO DA UNA NOSTRA APPLICAZIONE 




Ci CD U WEB 

OfficeRTF.zip 



^ 



REQUISITI 



■ illNilllli'll'IlM 

S Conoscenze di base 
' sulla gestione dei file, 

degli oggetti e di 

Office XP 



Piattaforma Windows 
98 o superiore - Office 
XP -Visual Basic 6 SP6. 




M 



entre da Microsoft arrivano indiscre- 
zioni sulla prossima versione di Office - 
, Office 2007, noi abbiamo pensato di de- 
dicare un articolo all'interazione tra Visual Basic 
e Office XP. L'abbiamo fatto, non perché siamo 
preistorici, come recita una nota pubblicità della 
Microsoft, ma perché riteniamo ancora interes- 
santi le applicazioni realizzabili in questo am- 
biente. Infatti, Office XP grazie a Visual Basic ed ai 
formati Open supportati, come RTF (Rich Text For- 
mat) e XML, può essere reso più produttivo, in nu- 
merosi campi, ed aperto verso altre applicazioni 
e sistemi. Ricordiamo che l'RTF, come il PDF, è una 
specifica pubblica per la creazione, lo scambio e la 
distribuzione di documenti, per cui oltre a dare 
una sommaria descrizione del formato RTF, ve- 
dremo come utilizzarlo nell'ambiente Visual Ba- 
sic - Office XP. In particolare introdurremo il con- 
trollo RichTextBox (casella di testo RTF) che uti- 
lizzeremo per realizzare un raccoglitore di documenti 
Office (Word ed Excel). Poi presenteremo un'altra 
applicazione che permette di creare documenti 
Word in base ad un Modello, cioè un file .dot. 



RICHTEXTBOX, 
RTF E OLE 

Il controllo RichTextBox, che supporta il formato RTR 
permette di manipolare testo, immagini e oggetti 
OLE in modo avanzato rispetto ai tradizionali Text- 
Box: per capirci, esso è assimilabile ad un racco- 
glitore di oggetti. La pagina delle proprietà del con- 
trollo, tra l'altro, permette di specificare il percor- 
so di un file da caricare, l'aspetto del controllo 
{multiline, scrollbars), abilitare o no i menu po- 
pup [AutoVerbMenu] , ecc. Il controllo RichText- 
Box inoltre permette di incorporare al suo inter- 
no oggetti OLE e di aprire e salvare file sia in formato 
RTF che Ascii. Per esempio nel controllo è possibile 
inserire tabelle Excel, file Word, Grafici ecc, anche 
attraverso il Drag & Drop. Il controllo OLE (che si 
trova tra i controlli primitivi di Visual Basic) permette 
d'inserire degli oggetti nei Form. Ricordiamo che, 



la tecnologia OLE, per certi versi, è stata soppian- 
tata da quella basata sugli Activex che ormai sono 
gli elementi standard dell'interfaccia utente. Nei no- 
stri esempi il controllo OLE verrà utilizzato per in- 
serire degli oggetti nel controllo RichTextBox. Per 
quanto riguarda il formato RTF, la codifica del te- 
sto è "tagged", nel senso che il contenuto del do- 
cumento è specificato in dei marcatori o Tag. 
Un esempio di file RTF è il seguente: 

{\rtfl\ansi\ansicpgl252\deff0\deflangl040 

{\fonttbl{\fO\fnil\fcharsetO 

Times New Roman;} 



> 



\viewkind4\ucl\pard\f0\fs60 



{\b io{\i Programmo} 



> 



\par } 

Scrivete il codice precedente in un file di testo, 
salvatelo con estensione RTF ed otterrete il do- 
cumento che contiene la parola ioProgrammo. 
Nella guida in linea di Visual Basic è riportato l'e- 
lenco delle istruzioni RTF interpretate dal con- 
trollo RichTextBox. Negli esempi, del controllo 
OLE utilizzeremo le proprietà OLETypeAllowed 
e Class e il metodo InsertObjDlg. OLETypeAl- 
lowed imposta il tipo oggetto supportato dal 
contenitore OLE, oggetti collegati, se -VhOLE- 
Linked, incorporati invece se -VbOLEEmbed- 
ded. Class restituisce il nome di classe di un og- 
getto incorporabile cioè Word.Document.x, Ex- 
cel.Sheet.x (x è il numero di versione) ecc. In- 
sertObjDlg visualizza la finestra che permette 
di selezionare l'oggetto da incorporare. Del con- 
trollo RichTextBox utilizzeremo il metodo Sa- 
veFile, che consente di salvare il contenuto in for- 
mato RTFo TXT, e la collezione OLEObjects che 
contiene gli oggetti incorporati nel controllo. 
Per inserire un oggetto nella collezione biso- 
gna utilizzare il metodo ADD che ha la seguen- 
te sintassi: 

Add indice, chiave, documentoorigine, classe 
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L'unico parametro obbligatorio è il nome del 
documento da incorporare (documentoorigi- 
ne). Il valore di Classe si può ricavare con l'og- 
getto OLE, la chiave è una stringa univoca che 
potrà servire per selezionate l'oggetto con il 
metodo Item. 



UN RACCOGLITORE 
OFFICE 

In questo paragrafo descriviamo come creare 



IsJfjT^ Tj^^B^^n^^ff^mìQ^Mi^^^MB 



1 



FrmContenitoi* 



insersci salva RTF 



RichTeKtBox 



UE 



Fig. 1: La form con oggetto OLE e RichTextBox 

un raccoglitore di documenti Office XP utilizzando 
un controllo OLE ed un RichTextBox. 

1 Create un nuovo progetto e referenziate la li- 
breria Microsoft Rich Textbox Control (RI- 
CHTX32.ocx) e la MS Common Dialog Control. 
Sul form disponete un RichTextBox, un con- 
trollo OLE e un menu a tendina. In quest'ultimo 
prevedete i menu Inserisci e Salva RTF. Inserisci 
permette di selezionare l'oggetto da inserire 
nel RichTextBox, Salva RTF invece permette di 
salvare il contenuto del RichTextBox in un file 
in formato RTF. 

2 Nella parte dichiarativa della Form bisogna 
inserire la dichiarazione della variabile num 
che servirà come contatore degli oggetti inserite 
nel RichTextBox. Nella FormJResize, invece, bi- 
sogna inserire il codice che permette di ridi- 
mensionare il RichTextBox in base alle dimen- 
sioni del Form. Il controllo OLE1, naturalmen- 
te, non deve essere visibile. 

Dim num As Integre 

Private Sub Fo rm_R.es ize() 
ScaleMode = 1 
On Error Resumé Next 
testo RTF. Left = 



testoRTF.Height = 


= (Me 


.Height 


- testoRTF.Top) 


testoRTF.Width = 


Me.Width - 


100 


End Sub 



311 codice da inserire nelle voci di menu è il se- 
guente. 

Private Sub mnuinserisci_Click() 
OLEl.OLETypeAllowed = vbOLEEmbedded 



OLEl.InsertObjDIg 



If OLE1. Class <> "" Then 



CommonDialogl.FileName = "" 



CommonDialogl.ShowOpen 



If CommonDialogl.FileName <> "" Then 



num = num + 1 



testo RTF. O LEO bjects. Ad d , "oggetto" + _ 
CStr(num), CommonDialogl.FileName, OLE1. Class 
End If 
End If 
End Sub 

Nella mnuinserisci_Click prima è abilita la ma- 
schera del controllo OLE } poi è invocato il metodo 
ShowOpen del CommonDialogl che permette di 
selezionare un documento dell'applicazione OLE 
scelta. Questo documento, grazie alla ADD, è inserito, 
nel RichTextBox, nel punto in cui si trova il curso- 
re del mouse. Il codice per salvare il contenuto del 
RichTextBox in un file RTF è il seguente. 



Private Sub mnuRTF_Click() 

CommonDialogl.FileName = "" 

CommonDialogl. Filter = "(*.rtf Documento RTF)|*.rtf" 

CommonDialogl. ShowSave 

testoRTF.SaveFile Me. CommonDialogl.FileName, 

rtfRTF 

Exit Sub 
errore: 

MsgBox Err.Description 
Err.Clear 



End Sub 



Prova documento 
io Programmo 



Quello ;! ; sopra è un documento '■•■'■/oid 




ìe bitmap 

firnagine di Microsoft Word 
ine Paint 
Microsoft Equatori 3.0 
Pacchetto 



I 



I - Visualizza come icona 



Inserisce un nui g l li tipo "Grafico di 

Microsoft Office Excel" ne. documento. 




FORMATI 
APERTI- RTF, 
PS ECC- 
iii generale si parla di 
testi non formattati 
(nel caso del TXT), testi 
formattati (HTML, RTF, 
DOC) e testi formattati 
per la stampa (PS, 
PDF). Il formato può 
essere di tipo 
proprietario o aperto, 
in quest'ultimo caso le 
specifiche di 
definizione sono di 
dominio pubblico. Tra i 
formati (o linguaggi di 
descrizione) pubblici 
ricordiamo il PDF, il PS 
e l'RTF. L'RTF è stato 
introdotto dalla 
Microsoft e, per certi 
versi, ricalca le 
caratteristiche del 
formato DOC. 



Fig. 2: La fase di inserimento di un oggetto 
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ALCUNI ELEMENTI 
DI WORD 

Descriviamo sommariamente alcuni elementi Word 
che utilizzeremo negli esempi. I Template o i mo- 
delli di Word sono dei file con estensione .dot che 
contengono gli elementi per la definizione delle 
caratteristiche di singoli documenti. Il modo più 
semplice per creare un Template è selezionare il 
menu "Wiew/Task Pane" e sulla finestra che com- 
pare (Task Pane) selezionare General Templates. 
Questa azione fa comparire la finestra New Docu- 
ment con l'elenco dei tipi di documenti che si pos- 
sono creare, per il nostro scopo bisogna selezio- 
nare Black Document con l'opzione Create New 
Templates. Il Template, e quindi i documenti da es- 
so ricavati, possono essere personalizzati inseren- 
do elementi (oggetti o macro) nelle sue varie par- 
ti. Come vedremo, negli esempi, nel nostro Tem- 
plate prevediamo tre Procedure (Macro) che, in- 
terfacciandosi con un'applicazione Visual Basic, 
permettono d'impostare gli elementi dell'intesta- 
zione, del corpo e del pie del documento. La pro- 
cedura relativa al corpo tra l'altro inserisce due 
Fields di Documento associati alle relative Varia- 
bili che, naturalmente, abiliteremo da Visual Ba- 
sic. Le Variabili di documento sono delle variabili 
che servono per memorizzare dei valori da utiliz- 
zare nell'intero documento; le Variabili di docu- 
mento sono membri della collezione Variables. Per 
inserire una Variabile nella collezione si può uti- 
lizzare il metodo ADD. I Fields (Campi) di Docu- 
mento di tipo DOCVARIABLE, invece, servono per 
rendere visibili i valori delle Variabili. I Fields , a lo- 
ro volta, sono membri della collezione Fields che rap- 
presenta l'insieme dei Fields associati al documento 
attivo. Per inserire un Field alla collezione bisogna 
usare il metodo ADD che ha la seguente sintassi. 

Add(Range, Type, Text, PreserveFormatting) 

dove Range rappresenta l'area del documento in 
cui i Fields operano, nei nostri esempi scriveremo 




Gli Smart Tag sono gli elementi 
intelligenti di Office XP. Essi dal 
punto di vista dell'utilizzatore sono 
delle stringhe (label) associate ad 
un tipo d'informazione, in genere, 
racchiusa in un'applicazione 
esterna ai Documenti Office. Dal 
punto di vista del programmatore, 
invece, lo Smart Tag è un 
componente COM che implementa 
alcune interfacce della libreria 
Microsoft Smart Tags. 
Per attivare gli Smart Tag, nei 
documenti Word, si deve usare il 



menu Tolls/AutoCorrect Options 
poi, nella finestra associata al 
menu, selezionare l'etichetta Smart 
Tags. In questa etichetta sono 
mostrati i vari tipi di Smart Tag. 
Gli Smart Document, invece, sono 
stati introdotti con Office 2003. Essi 
per quanto riguarda l'intelligenza 
"contestuale" sono l'evoluzione 
degli Smart Tag. Gli Smart 
Document sono strumenti che 
uniscono i vantaggi delle 
applicazioni desktop con quelli 
della tecnologia XML. 






Selection.Range (dove Selection rappresentala se- 
lezione corrente su una finestra o un pannello). 
Type, opzionale, rappresenta il tipo di testo che si 
vuole associare al Field, nel nostro caso sarà wd- 
FieldEmpty (campo vuoto) che è il tipo di Default. 
Text, anch'esso opzionale, rappresenta il testo d'as- 
sociare al Field, nel nostro caso il testo lo fornisce 
una variabile di Documento, caricata con il valore 
passato da Visual Basic. Nella procedura Wcorpo, 
descritta sotto, che gestisce gli elementi del corpo 
del documento, infatti, è previsto il seguente co- 
dice Text- "DOCVARIABLE"" VarBodyl """ed. In- 
fine c'è il parametro PreserveFormatting che preserva 
la formattazione del campo durante l'aggiorna- 
mento - UpDate - dei Fields. L' UpDate dei Fields è 
necessario per assicurare il refresh dei valori visi- 
bili nel documento, questo soprattutto dopo che 
si è assegnato un nuovo valore alla variabile asso- 
ciata al campo, come sarà chiaro tra poco. 
Nella procedura, Visual Basic, per invocare le Ma- 
cro del modello utilizziamo il metodo Run di Word 
Application. La sintassi del metodo è la seguente: 

espressione. Run(MacroName, vargl, ..., varg30) 

Il metodo richiede il nome della Macro nel forma- 
to MacroName:- "Nome" e, se necessari, i parame- 
tri nel formato vargl '.-"valore del parametro". No- 
tate che è possibile passare fino a 30 parametri. Per 
spostare il cursore tra due Fields "DocVariable" uti- 
lizziamo il metodo GoTo. Esso restituisce un og- 
getto Range che rappresenta la posizione iniziale del- 
l'elemento specificato. La sintassi di GoTo è la se- 
guente: 

Espressione. GoTo(What, Which, Count, Name). 

What rappresenta il tipo di elemento in corri- 
spondenza del quale verrà spostata la selezione, 
nel nostro caso è appunto un Field. Which speci- 
fica come verrà fatto lo spostamento, nel nostro 
caso wdGoToNext (Successivo). Co unt specifica di 
quanti elementi bisogna spostarsi. Name specifica 
il nome del tipo di elemento, nel nostro caso è 
"DOCVARIABLE". 



APPLICAZIONE 
VISUAL BASIC - WORD 

Di seguito presentiamo l'applicazione Visual Ba- 
sic che permette di creare dei documenti Word, 
sulla base di un modello (Template). Questi sa- 
ranno personalizzati, con immagini, oggetti e strin- 
ghe, utilizzando i comandi presenti su un Form Vi- 
sual Basic. In particolare prevediamo di gestire l'in- 
testazione del documento, il corpo e il pie. All'in- 
testazione passiamo un'immagine (il logo) ed un te- 
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sto; al corpo passiamo il testo dell'oggetto e quel- 
lo del contenuto vero e proprio. Nel pie, invece, 
impostiamo la data e il numero di pagina. Iniziamo 
presentando gli elementi da inserire sulla Form, 
poi passeremo a descrivere il modello Word ed in- 
fine introdurremo il codice da inserire nella Form. 



due parametri; WPiede, che in base ai valori di due 
parametri Boolean può impostare la data e il numero 
di pagina nel piede del documento infine la Ma- 
cro WCorpo, senza parametri, ma che al suo inter- 
no definisce due Fields di documento. Come ac- 
cennato i parametri e i Fields sono impostati da 
Visual Basic. Le Macro sono le seguenti. 




LA FORM 

DEL PROGETTO VB 

1 Create un nuovo progetto e referenziate le li- 
brerie: Microsoft Rich Textbox Control e Com- 
mon Dialog. Sulla Form prevedete gli elementi che 
permettono di definire ed inviare il testo e l'im- 
magine al documento Word. In particolare inseri- 
te: 2 TextBox, nominati txtintestazione e txtogget- 
to; un RichTextBox nominato txtcorpo; una Pictu- 
reBox, nominata Picturelogo che conterrà l'ante- 
prima dell'immagine del logo. Inoltre inserite due 
CheckBox per specificare che cosa bisogna impo- 
stare nel pie pagina cioè Checkdata e CheckPagina. 
Infine inserite i pulsanti per creare il documento 
Word (nominato Crea), per inviare i dati {Invia) , 
per salvare il documento (salva), per salvare il con- 
tenuto del TxtCorpo in formato RTF e per caricare 
il logo (pulsante logo) . Prevedete anche i pulsanti 
conta e controlla per utilizzare i servizi di Word che 
permettono di contare i caratteri e di verificare la 
sintassi del testo presente in TxtCorpo. Disponete 
il tutto come in Figura 3. 



^ 



ata N. Pagina 



laDati Salva SalvaRTF 



Conta ! 



Fig. 3: La Form dei generatore di documenti Word 



IL CODICE DEL MODELLO 
WORD 

2 Create un modello Word, nominatelo Model- 
lo.dot, e salvatelo nella stessa directory che con- 
terrà il progetto Visual Basic. In questo modello, 
prima del salvataggio, dovete inserire (nei modu- 
li Visual Basic Word) le Macro: WIntestazione, che 
inserisce un'immagine ed una stringa nell'inte- 
stazione del documento, questi sono ricevuti con 



Sub Wintestazione(para As String, immagine As String) 
ActiveWindow.View.Type = wdPrintView 
ActiveWindow.ActivePane.View.SeekView = _ 

wdSeekCurrentPageHeader 
If immagine <> "" Then 
Selection.InlineShapes.AddPicture FileName:= _ 

immagine, LinkToFile _ 
:=False, SaveWithDocument:=True 
End If 
Selection.EndKey Unit:=wdl_ine 



Selection.TypeText Text:=para 



ActiveWindow.ActivePane.View.SeekView = _ 

wdSeekMainDocument 
End Sub 

Nella WIntestazione, innanzitutto, s'imposta il do- 
cumento in Layout di stampa (wdPrintView), al- 
trimenti non si può selezionare l'intestazione e il Pie, 
dopo si abilita l'intestazione {wdSeekCurrentPa- 
geHeader) del documento e s'inseriscono l'imma- 
gine ed il testo passati come parametri. Notate che 
l'immagine è passata attraverso il suo Path e che 
con SaveWithDocument:-True si stabilisce che 
l'immagine verrà salvata nel documento. 

Sub WPiede(data As Boolean, npagina As Boolean) 
ActiveWindow.ActivePane.View.Type = wdPrintView 
ActiveWindow.ActivePane.View.SeekView = 

wdSeekCurrentPageFooter 
If data Then 



Selection. Fields. Add Range: 



=Selection.Range, 

Type:=wdFieldDate 



End If 



If npagina Then 



With Selection. Sections(l) .Headers(l).PageNumbers 
.NumberStyle = wdPageNumberStyleArabic 



.HeadingLevelForChapter = 



.IncludeChapterNumber = False 



.ChapterPageSeparator = wdSeparatorHyphen 
.RestartNumberingAtSection = False 
.StartingNumber = 
End With 

Selection. Sections(l).Footers(l).PageNumbers. Add 
PageNumberAlignment:= _ 
wdAlignPageNumberRight, FirstPage:=True 

End If 

If ActiveWindow.View.SplitSpecial <> 

wdPaneNone Then 
ActiveWindow.Panes(2).CIose 
End If 
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ActiveWindow.ActivePane.View.SeekView = 

wdSeekMainDocument 

End Sub 

Sub WcorpoQ 



Selection.TypeParagraph 



Selection.Fields.Add Range:=Selection.Range, _ 
Type:=wdFieldEmpty, Text:="DOCVARIABLE 

""VarBodyl"' 
PreserveFormatting : =True 
Selection.EndKey Unit:=wdLine 
Selection.TypeParagraph 
Selection.TypeParagraph 

Selection.Fields.Add Range:=Selection.Range, _ 
Type:=wdFieldEmpty, Text:="DOCVARIABLE 

""VarBody2"' 



PreserveFormatting : =True 



IL CODICE 

DEL PROGETTO VB 

3 Per punti presentiamo le parti principali del 
codice Visual Basic da inserire nella Formi. 

a) Nella parte dichiarativa e nella Form_Load pre- 
vediamo il seguente codice. 

Dim objWor As Object 

'Oggetto Application 

Dim objDoc As Object 

'Oggetto Document 

Dim DocumentName as String 

'Il nome del Template 



Private Sub Form_l_oad() 



TxtCorpo.AutoVerbMenu = True 



End Sub 



End Sub 



In base a quello illustrato s'intuisce che la procedura 
WCorpo crea due Fields di Documento associati 
alle variabili nominate VarBodyl e VarBody2. 1 due 
Fields sono divisi da due righe vuote (Selection. Ty- 
pePamgmph). 






fflRoGRAMMQ: 



Oggetto. Presentazione rivista 
Io Programmo la rivista più ... 



Fig. 4: Un documento Word dopo l'invio dei dati 

Notate che Selection.EndKey Unit.-wdLine equi- 
vale alla selezione del tasto Fine cioè sposta il cur- 
sore alla fine della riga. Questo è necessario per 
evitare che, con l'inserimento della nuova linea, il 
Field VarBodyl venga portato sotto. 



Le tre variabili precedenti sono Object, poiché nel 
progetto utilizziamo la CreateObject, e non refe- 
renziamo direttamente le librerie di Office (per 
questo motivo nelle procedure sono state definite 
alcune costanti di Word). 

b) Dopo aver inserito i dati nella form per creare 
il documento bisogna cliccare il pulsante Crea. 
La Crea_Click è la seguente. 

Private Sub Crea_Click() 
DocumentName = App.Path + "/Modello. dot" 
Set objWor = CreateObject("Word. Application") 
objWor.Documents.Add Template := DocumentName, _ 
NewTemplate: =False 
Set objDoc = objWor.ActiveDocument 
MsgBox "Il Documento Word Creato è" _ 
" in secondo piano", vblnformation 
objWor.Visible = True 
objWor.WindowState = 1 

End Sub 



Nella procedura dopo la creazione dell'applica- 
zione Word è inserito un nuovo documento, nella 
collezione dei documenti, poi l'oggetto objDoc si fa 
referenziare al documento attivo. 



ACTIVEX E RACCOGLITORE OFFICE 



componenti ActiveX, che hanno 
soppiantato la tecnologia OLE, 
rispecchiano in modo più realistico 
le funzioni di Visual Basic per lo 
sviluppo semplice e rapido di 
componenti software affidabili che 
interagiscono tra loro. Gli Activex 
possono essere raggruppati in 
oggetti raccoglitori. 
Il raccoglitore di Activex principali 
sono: Microsoft Internet Explorer e 
Microsoft Office Binder 



(raccoglitore di Office). 
Quest'ultimo può essere installato 
tramite il CD di Microsoft Office. 
Il raccoglitore di Office da 
programma si controlla con gli 
oggetti: Binder, che rappresenta un 
raccoglitore office; Section che 
rappresenta una parte di un singolo 
documento, cioè una sezione del 
raccoglitore e l'oggetto Sections 
che rappresenta l'insieme delle 
sezioni del raccoglitore. 



e) La procedura seguente, invece serve per av- 
viare l'esecuzione delle Macro e per passare i 
valori ai Fields. 

Private Sub Macro_Click() 
Const wdGoToField = 7 
On Error GoTo errore 
If objDoc Is Nothing Then 
Crea_Click 
End If 



objDoc. Application. Run 

MacroName: 



= "Wintestazione" 



varg 1 : = Me.Txtlntestazione, varg2 : 
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CommonDialogl.FileName 



Word.Quit 



If (Me.Checkdata.Value Or Me.Checkpagine.Value) 

Then 
objDoc. Application. Run MacroName:="WPiede", _ 



End Sub 



vargl: 



End If 



= Me.Checkdata.Value, 

varg2:=Me.Checkpagine.Value 



objDoc. Application. Run MacroName: = "Wcorpo" 

objDoc.Variables.Add Name: = "VarBodyl", _ 

Value: = "Oggetto: " + Me.Txtoggetto 

objDoc. GoTo What:=wdGoToField, _ 

Which:=wdGoToNext, Count: = l, 
Name: ="DOCVARIABLE" 

objDoc.Variables.Add Name: = "VarBody2", _ 

Value: = Me.TxtCorpo.Text 

objDoc. Fields. Update 

objWor.Visible = True 

objWor.WindowState = 1 

objWor.Activate 

Exit Sub 

errore: 

MsgBox Err.Description 

Err.Clear 
End Sub 

Nella procedura, quindi, sono fatte le seguenti 
azioni: si eseguono le tre macro con Run, si asso- 
ciano le variabili di documento ai Fields, si fa 
TUpdate. 



Editor di menu 



Camion: I nnenupop 
Nanne: | nnnucopy 
Index: 



Annulla 



HelpContextlD: fo 

r Checked R Enabled l~ Msiblei 



Shortcut: | (nessuna) ▼ ! 

NegotiatePosition: jp-None ^| 



V WindowList 




Flg. 5: Il menu a tendina del PopUp 

d) Le procedure per contare il numero di caratte- 
ri del campo TxtCorpo e per controllarne la sin- 
tassi sono le seguenti. 

Private Sub Conta_Click() 

Const wdDialogToolsWordCount = 228 

Const wdDoNotSaveChanges = 

Dim Word As Object 

Set Word = CreateObject("Word. Application") 

Set doc = Word.Documents.Add 

Word.Selection.Text = TxtCorpo.Text 

Word. Dialogs(wdDialogToolsWordCount). Show 

Word.Visible = False 

doc.Close wdDoNotSaveChanges 



Private Sub controlla_Click() 



Const wdDialogTooIsSpellingAndGrammar = 828 
Const wdDoNotSaveChanges = 



Dim Word, doc As Object 



Set Word = CreateObject("Word. Application") 
Set doc = Word.Documents.Add 
Word.Selection.Text = Me. TxtCorpo.Text 
Const wdltalian = 1040 
Word.Selection.LanguagelD = wdltalian 
Word.Dialogs(wdDialogToolsSpellingAndGrammar 

).Show 
Word.Visible = False 
If Len(Word.Selection.Text) <> 1 Then 
Me. TxtCorpo = Word.Selection.Text 
End If 

doc.Close wdDoNotSaveChanges 
Word.Quit 
End Sub 



e) Per caricare l'immagine nella PictureBox, per 
salvare il documento e il campo TxtCorpo in 
formato RTF, usiamo le seguenti procedure: 

Private Sub SalvaRTF_Click() 

Me. CommonDialogl.FileName = "" 

Me.CommonDialogl.Filter = "(*.rtf)|*.rtf|filertf" 

Me.CommonDialogl.ShowSave 

Me.TxtCorpo.SaveFile 

Me. CommonDialogl.FileName, rtfRTF 

Exit Sub 
errore: 

MsgBox Err.Description 
Err.Clear 
End Sub 

Private Sub salvaword_Click() 
If objDoc Is Nothing Then 

MsgBox "Creare prima il documento Word" 

Exit Sub 
End If 

objWor.Dialogs(wdDialogFileSaveAs).Show 

objWor.Quit 
End Sub 
Private Sub load_Click() 

CommonDialogl.FileName = "" 

OpenFile 
End Sub 
Sub OpenFile() 
On Error GoTo errore 

If CommonDialogl.FileName = "" Then 

With CommonDialogl 
.ShowOpen 
End With 

End If 

If CommonDialogl.FileName <> "" Then 
Picturelogo.Picture = LoadPicture( 

CommonDialogl.FileName) 




j^^B 



In un documento 
Word, per inserire, un 
Field di nome 
"DocVariable" si può 
utilizzare la finestra 
Field ... (in italiano 
Campo ...) 
selezionabile 
attraverso il menu 
Insert/Field 
(Inserisci/Campo). In 
questa finestra 
bisogna specificare il 
nome del Field ( cioè 
"DocVariable") ed il 
nuovo nome che 
rappresenta il nome 
della variabile 
associata. Se su questa 
finestra si vuole 
vedere il codice di 
campo che sarà 
inserito nel 
documento, basta 
cliccare il pulsante 
Field Code. 
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End If 



Exit Sub 



errore: 



MsgBox Err.Description 



Err.Clear 



End Sub 



f) 



Dato che nel controllo RTF è possibile inseri- 
re anche delle immagini, il metodo più sem- 
plice per farlo è quello di usare i comandi det- 
ti VerbMenu cioè il copia ed incolla. In partico- 
lare copiamo l'immagine della PictureBox e la 
incolliamo sul RichTextBox. Per abilitare que- 
sti comandi sul RichTextBox usiamo Auto- 
VerbMenu = True sulla PictureBox invece uti- 
lizziamo un PopupMenu. Il codice per far fun- 
zionare il Popupmenu è il seguente. 



Private Sub mnucopy_Click() 



Clipboard.Clear 



Clipboard.SetData Me.Picturelogo.Picture 



End Sub 



Private Sub Picturelogo_MouseDown(Button As Integer, _ 
Shift As Integer, X As Single, Y As Single) 



If Button = vbRightButton Then 



PopupMenu mnucopy 



End If 



End Sub 




Fig. 6: La form in fase di esecuzione 

Ricordiamo che per il PopUpMenu è necessario 
un menu a tendina con almeno una voce di menu 
con un sottomenu, come mostrato in Figura 6. 



USARE LE FUNZIONI 
DI EXCEL 

Nel progetto inserito nel CD allegato alla rivista ol- 
tre agli esempi introdotti nel corso dell'articolo, 



trovate un esempio dedicato ad Excel, cioè la Form 
nominata FrmExcel. Essa contiene gli elementi - 
una Listview, un CommonDialog, un TextBox e tre 
pulsanti - che permettono di aprire il foglio Excel 
nominato esempio_Excel.xls, leggerne il contenu- 
to e visualizzarlo su una ListView. Inoltre è pre- 
sente un pulsante che permette di calcolare la som- 
ma di alcuni valori presenti nel foglio Excel, invo- 
cando la funzione Excel Somma. Di seguito ripor- 
tiamo il codice contenuto in questo pulsante. 
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Fig. 7: La form che utilizza le funzioni di Excel 



Private Sub calcola_Click() 
letterecolonneEx = Array("A", "B") 
FoglioExcel.Worksheets(l). _ 
Range(letterecolonneEx(l) + "1:" + _ 
letterecolonneEx(l) + CStr(righe + l)).Select 
FoglioExcel.Worksheets(l). _ 
Range(letterecolonneEx(l) + _ 
CStr(righe + l)).FormulaRlCl = " 



= SUM(R[-10]C:R[-1]C)" 



Aggiungi righe + 1, "Somma " + _ 



CStr(FoglioExcel.Worksheets(l).Range( 

letterecolonneEx(l) . 



CStr(righe + 1))), "- 



Set AppExcel = Nothing 



Set FoglioExcel = Nothing 



Exit Sub 



errore: 



MsgBox "Errore " & Err.Number & . 



vbCrLf & Err.Description 



End Sub 
Il resto del codice lo trovate nel CD. 



CONCLUSIONI 

L'articolo è un valido ausilio per chi vuole ap- 
profondire le conoscenze sulle applicazioni della Sui- 
te Office. Gli esempi sono relativi a Office XP ma 
possono essere utilizzati anche con Office 2003. 

Massimo Autiero 
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WEB SERVICES 

CON VISUAL BASIC.NET 

OGGI È POSSIBILE UTILIZZARE I WEB SERVICES PER SVILUPPARE APPLICAZIONI 
DISTRIBUITE IN MANIERA SEMPLICE, SICURA E VELOCE. VB.NET CONTIENE STRUMENTI 
EFFICACI PER QUESTA TECNOLOGIA, VEDIAMO QUALI 
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In questo articolo cominceremo a lavorare con 
una tecnologia relativamente nuova, quale è 
quella dei web service. Solitamente le realtà 
informatiche che si avvalgono di questo tipo di 
soluzioni sono aziende medio-grandi che a loro 
volta forniscono prodotti per aziende medio gran- 
di. I motivi sono solitamente imputabili a due ra- 
gioni principali: la prima è che l'argomento web 
service viene solitamente presentato nei suoi 
aspetti di più basso livello senza invece eviden- 
ziarne le sue potenzialità ad alto livello. È normale 
quindi che in molte situazioni si preferisca non 
abbandonare le vecchie soluzioni, sulle quali si 
possiede un know-how già consolidato, piuttosto 
che intraprendere soluzioni apparentemente osti- 
che ed i benefici delle quali non appaiono così evi- 
denti. La seconda va invece attribuita al fatto che i 
web service danno "il meglio di se stessi" in un'ar- 
chitettura distribuita, ed in questo caso si intende 
in particolar modo un'architettura geografica- 
mente distribuita, cioè in una situazione peculiare 
di chi ha ad esempio più filiali dislocate su un 
ampio territorio che in qualche modo devono 
comunicare tra loro. 



DALLA 

PROGRAMMAZIONE 
OBJECT ORIEMTED 
A QUELLA SERVICE 
ORIEMTED 

La breve introduzione sopra ci servirà proprio per 
tentare di superare quei due punti evidenziati for- 
nendo un punto di vista molto più operativo di 
quanto solitamente viene proposto. Partiamo da 
un'analogia con la quale, bene o male, tutti abbia- 
mo fatto i conti. Una delle grandi rivoluzioni nel 
campo della programmazione è stata sicuramente 
l'introduzione degli oggetti, l'altra è quella della 
nascita e diffusione di internet. Ora provate a met- 
tere insieme le due cose e che otterrete? Neanche 
a dirlo i web service! Uno dei concetti principali in 
ambito 00 è che un oggetto può essere visto come 




Fig.l: Un tepositoty centralizzato con più "client" 
sparsi di cui non possiamo predire né il numero né la 
piattaforma. 

una black box di cui è necessario conoscere sola- 
mente l'interfaccia senza doversi preoccupare 
della sua implementazione interna. Questo infatti 
ci permette di sfruttare un'infinità di librerie ester- 
ne (note anche come API) senza avere nessun tipo 
di informazione su come esse siano state imple- 
mentate. D'altro canto è anche ovvio che non è 
possibile utilizzare delle API scritte in un linguag- 
gio su un altro; ad esempio una libreria scritta in 
.NET non è utilizzabile su una piattaforma Java. 
Ora poniamoci un caso d'uso concreto: supponia- 
mo di aver necessità di dover sviluppare un'appli- 
cazione che interagisca con un database centraliz- 
zato dislocato in una qualsiasi punto della terra. 
Supponiamo inoltre che l'applicativo dovrà girare 
su piattaforme diverse (Windows, Linux etc.) e 
che implicitamente od esplicitamente venga im- 
posto anche l'ambiente di sviluppo (.NET, Java, 
PHP, Perl). La Figura 1 schematizza quanto detto 
fin qui. Una soluzione tra le più immediate da 
pensare ma meno efficiente dal punto di vista pro- 
gettuale è quella di scrivere ogni volta l'applicazio- 
ne ex novo, facendosi carico quindi sia della busi- 
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ness logie sia dell'interazione con il DBMS centra- 
le. Se da una parte la business logie può essere in 
gran parte progettata astraendo dallo specifico lin- 
guaggio di programmazione, maggiori problemi 
vengono posti per quel che riguarda il secondo 
aspetto. Nel migliore dei casi avremmo bisogno 
degli opportuni driver per ogni specifico linguag- 
gio che usiamo e dovremmo lasciare aperta un 
porta dedicata sia sul server centralizzato che 
ospita il DB sia sulla macchina che ospiterà l'ap- 
plicazione con tutti i problemi di sicurezza che ne 
conseguono. Inoltre, pur ammesso di essere 
disposti a sobbarcarci questi inconvenienti, dob- 
biamo anche tener presente un aspetto economi- 
co: alcuni RDBMS commerciali richiedono (sia per 
motivi di efficienza che economici) che le interro- 
gazioni a DB passino attraverso un loro client pro- 
prietario e, solitamente, qui entrano in gioco le 
cosiddette licenze cali. Non sarebbe forse molto 
meglio creare "un'applicazione" che si occupi di 
esporre un'unica interfaccia che permetta l'intera- 
zione col DB e che allo stesso tempo sia usufruibi- 
le da qualsiasi linguaggio di programmazione? 
Beh, se questo è ciò che stiamo cercando, i web 
services sono la nostra soluzione. 
Da questo esempio, che verrà sviluppato e imple- 
mentato nel seguito dell'articolo, possiamo quindi 
fissarci fin d'ora una idea cardine: possiamo crea- 
re un'istanza di un qualsiasi web service come se 
istanziassimo una qualsiasi classe da una libreria 
esterna e utilizzarla a nostro web service. 



BREVE OVERVIEW 
SUI WEB SERVICES 

Abbiamo già detto che i web services permettono 
il dialogo tra diverse piattaforme e rendono possi- 
bile l'esportazione di componenti già esistenti 
verso client diversi. Il bello è che tutto ciò si basa 
su protocolli ben noti e di largo utilizzo. 
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Fig.2: Stack di protocolli su cui si basano i web service 

Come mostrato in Figura 2 i web services si basa- 
no su quattro protocolli: 

• xml è il metalinguaggio per antonomasia e vie- 
ne usato per l'esportazione dei dati 

• soap è lo standard che definisce il formato dei 
messaggi che saranno scambiati tra client e 



servizio 

• wdsl è il protocollo utilizzato per la definizione 
dei parametri e dei metodi 

• uddi è lo standard promosso dal consorzio 
"uddi" per facilitare la ricerca dei servizi in 
rete, su di esso si basano delle specie di motori 
di ricerca per trovare i web service. 

Approfondire ogni singolo aspetto di questo stack 
non rientra certo tra gli obiettivi di questo articolo 
e tra l'altro, come già accennato, è uno dei motivi 
che rende poco gradevole tale argomento. A noi 
basta capire i principi che permettono l'astrazione 
e la comunicazione tra piattaforme non omoge- 
nee. Un web service in fondo non deve far altro 
che comunicare al client la propria interfaccia in 
modo tale che quest'ultimo possa al momento op- 
portuno invocare i metodi che desidera. Ciò è reso 
possibile grazie al WSDL (Web Services Description 
Language); per rimanere nel concreto vediamo fin 
da ora come è strutturato il messaggio WSDL del 
web service messo a disposizione da google. 
In particolare, come ovvio, Google mette a disposi- 
zione un web service che consente di effettuare ri- 
cerche come se si interrogasse dal proprio brow- 
ser. Per ragioni di brevità analizzeremo solo alcuni 
tratti del file XML che descrive il messaggio WSDL, 
ad ogni modo chi volesse approfondire quest'a- 
spetto può scaricarsi le API del web service di goo- 
gle dal sito http://www.google.com/apis/download 
.htm. La prima informazione che si ottiene è la 
definizione: 

<definitions name="GoogleSearch" 

targetNamespace="urn:GoogleSearch" 
xmlns:typens="urn:GoogleSearch" 
xmlns:xsd=" http: //www. w3.org/2001/XMLSchema" 
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/ 
" xmlns:soapenc="http://schemas.xmlsoap.org/soap/ 
encoding/" xmlns:wsdl="http://schemas. xmlsoap.org 
/wsdl/" xmlns="http://schemas. xmlsoap.org/wsdl/"> 

Poi si passa a comunicare le classi che il web service met- 
te a disposizione, ad esempio una classe che Google met- 
te a disposizione è quella dei risultati provenienti dall'in- 
terrogazione: 

<xsd:complexType name="GoogleSearchResult"> 
<xsd:all> 

<xsd:element name="documentFiltering" 

type="xsd : boolean"/> 
<xsd:element name="searchComments" 

type="xsd:string"/> 
<xsd:element name= 

"estimatedTotaIResultsCount" type="xsd : int"/> 
<xsd:element name="estimateIsExact" type= 

"xsd:boolean"/> 
<xsd:element name="resultElements" 
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WINDOWS 
O LINUX? 

Chi vi scrive è tenden- 
zialmente abituato a 
sviluppare su piattafor- 
me Linux, visto però 
che l'intento di questo 
articolo è quello di far 
sperimentare i web 
service al maggior 
numero di lettori pos- 
sibile si è optato per la 
piattaforma più diffu- 
sa. Ci si può comunque 
avvalere di strumenti 
diversi ed ottenere i 
medesimi risultati. In 
particolare una tra le 
tante scelte che mi sen- 
to di consigliare è una 
architettura LATJE, 
ossia Linux Apache 
Tomcat Java Eclipse. 
Per essere un po' più 
precisi Apache sarà il 
vostro web server, 
Tomcat il container, 
Java il linguaggio di 
programmazione ed 
Eclipse l'IDE per svilup- 
pare in tutta comodità. 
Inoltre, per sfruttare al 
massimo le possibilità 
di Eclipse suggerisco di 
installare anche il plug- 
in Lavadora all'indiriz- 
zo Jitt£7/lavadora 
.sourceforge.net/. 
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type="typens:ResultElementArray"/> 



type="typens:GoogleSearchResult"/> 



<xsd:element name="searchQuery" 

type="xsd:string7> 
<xsd:element name="startlndex" type="xsd:int7> 
<xsd:element name="endlndex" type="xsd:int"/> 
<xsd:element name="searchTips" 

type="xsd:string7> 
<xsd:element name="directoryCategories" 

type="typens:DirectoryCategoryArray"/> 
<xsd:element name="searchTime" 

type="xsd:double"/> 
</xsd:all> 
</xsd:complexType> 

<xsd:complexType name="ResultElement"> 
<xsd:all> 



<xsd:element name=' 



summary 

type="xsd:string7> 



<xsd:element name="URL" type="xsd:string7> 
<xsd:element name="snippet" type="xsd:string7> 
<xsd:element name="title" type="xsd:string7> 
<xsd:element name="cachedSize" 

type="xsd:string7> 
<xsd:element name="relatedInformationPresent" 
type="xsd : boolean"/> 
<xsd:element name="hostName" 

type="xsd:string7> 



<xsd:element name: 
type=' 



="directoryCategory" 
typens:DirectoryCategory"/> 



<xsd:element name="directoryTitle" 

type="xsd:string7> 



</xsd:all> 



</xsd:complexType> 

Come si può notare GoogleSearchResult oltre che 
contenere campi primitivi contiene a sua volta 
altre classi (ossia complexType) che a loro volta 
vengono definiti in maniera analoga. Alla fine di 
questa catena dovremmo comunque avere tutti 
dati serializzabili (proprio perché dovranno esse- 
re fatti viaggiare su internet) e nella grande mag- 
gioranza dei casi essi sono di tipo primitivo. 
Anche per quel che riguarda i metodi abbiamo 
una notazione del tutto simile: 



<message name="doGoogleSearch"> 


<part name= 


"key" 


type="xsd:string7> 


<part name= 


"q" 


type="xsd:string7> 


<part name= 


"start" 


type="xsd:int"/> 


<part name= 


"maxResuIts 


type="xsd:int"/> 


<part name= 


"filter" 


type="xsd:boolean'7> 


<part name= 


"restrict" 


type="xsd:string7> 


<part name= 


"safeSearch 


' type="xsd:boolean"/> 


<part name= 


"Ir" 


type="xsd:string7> 


<part name= 


"ie" 


type="xsd:string"/> 


<part name= 


"oe" 


type="xsd:string7> 


</message> 


<message name="doGoogleSearchResponse"> 


<part name= 


"return" 





</message> 

Ecco ad esempio come viene definito il metodo 
che permette di effettuare una ricerca e riceverne 
i risultati. 



SVILUPPARE 
UN WEB SERVICE 

Ora che abbiamo fatto un breve excursus sui web 
service vediamo come sia possibile ed estrema- 
mente semplice svilupparne uno. Prima di fare 
ciò facciamo luce sugli strumenti necessari per 
sviluppare e "far girare" un web service. 
Questo articolo è stato pensato per essere imple- 
mentato su una piattaforma Windows che fosse 
la più accessibile e diffusa possibile. Ciò di cui 
avremo bisogno sarà un web server (da non 
confondere con il web service che andremo noi 
ad implementare!) come US; esso è già presente 
di default sulla maggior parte delle installazioni 
di Windows XP Professional, la piattaforma .NET, 
e possibilmente anche Visual Studio che ci sem- 
plificherà notevolmente la fase di sviluppo. 
Inoltre, per rendere immediatamente possibile 
effettuare i nostri test in locale, utilizzeremo il 
Database NorthWind messo a disposizione da 
Access. Tornando al nostro progetto iniziale si 
tratterà quindi di inserire un layer suppletivo tra 
il database e le applicazioni client che puntano 
ad esso. 
Tale layer suppletivo sarà, come mostrato in 



Database 
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Client 
JAVA 






Client 
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Fig.3: Architettura con un web service che si frappo- 
ne tra il database ed i vari client 
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Figura 3, proprio rappresentato dal nostro web 
service che andremo adesso ad implementare. 



IMPLEMENTAZIONE 
DEL WEB SERVICE 

Possiamo sicuramente considerare un web servi- 
ce come una classe qualsiasi messa a disposizio- 
ne da .NET. In particolare per creare un web ser- 
vice basterà ereditare da System. Web. Services 
.Web-Service. Quindi nel nostro caso avremmo: 
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Fig.5: Finestra principale dell'applicazione client. 



Public Class Servicel 



Inherits System. Web. Services. WebService 



ElBla 

IH Soluzione "AppDB" (progetto 
B P AppDB 

Ei (jo) Reterences 

I Web Reterences 



E3 Assemblylnfb.vb 
il DataFormOrdini.vb 
E! DataForrnProdotti.vb 
UH ds.xsd 
M ds02.xsd 
|=1 Forrnl.vb 
3 Ordini. vb 



^Esplora sol,,, | ^ Visualizzazi. 



Fig.4: solution explorer 
dopo aver aggiunto la 
web reference 



Quando creiamo un 
web service con Visual 
Studio verrà creata 
una directory sotto 
quella principale di 
US, che per intenderci 
di default si tratta di 
C:\ inetpub\wwwroot. 
A questo punto pos- 
siamo implementare 
il nostro web service 
come se stessimo pro- 
grammando una qual- 
siasi classe, con un so- 
lo piccolo accorgi- 
mento ulteriore. 
Solitamente quando ci si occupa di programma- 
zione Object Oriented in fase di progettazione si 
decide quali metodi esporre come pubblici, pro- 
tetti o privati. Se ci si occupa di web service è ne- 
cessario specificare anche quali metodi siano 
visibili "lato web", ossia quali metodi siano utiliz- 
zabili, o meglio invocabili, dai client che si colle- 
gheranno. Sulla piattaforma .NET questo viene 
ottenuto utilizzando la label (o etichetta) Web- 
Method. Prima di vedere più nel dettaglio il codi- 
ce facciamo un'ultima considerazione. Abbiamo 
detto che il nostro web service funge da layer 
intermezzo tra database ed applicazioni client. 
Per ottenere questo risultato possiamo proget- 
tarlo seguendo due filosofie progettuali diverse. 
La prima è quella di realizzare un web service "su 
misura" del database; ad esempio se prendiamo 
in considerazione il database NorthWind e 
vogliamo rendere disponibili alcune informazio- 
ni sui clienti presenti nella tabella Clienti 
dovremmo ricevere in ingresso al metodo il 
nome, implementare all'interno la logica di 
interrogazioni e restituire i risultati. Se da un lato 
questa soluzione è molto sicura perché il client 
non si occuperà mai del database, dall'altra pre- 
suppone che ogni database abbia il suo web ser- 



vice specifico, perché cambiando il DB dovrà 
cambiare tutta la logica che sta dietro il web ser- 
vice stesso. Naturalmente chi vuole offrire un 
prodotto "già confezionato" tenderà solitamente 
a seguire una strada di questo tipo. Se però siamo 
comunque sempre noi anche a fornire le appli- 
cazioni client ci converrà tenere la soluzione web 
service il più aperta possibile e spostare la logica 
dal lato dell'applicazione. Come avrete sicura- 
mente intuito sarà questa seconda soluzione che 
andremo a sviluppare. Per tenere quindi il nostro 
web service il più generale possibile, faremo in 
modo che i suoi metodi si occupino di ricevere in 
ingresso un generico comando SQL, ad esempio 
un web method utile potrebbe essere: 

<WebMethod()> 

Public Function query(ByVal strSql As String, 

ByVal strConnect As String) As DataSet 
Dim oDataSet As New DataSet 
Dim objConn As New 



MA COME SI TROVANO I WEB SERVICE? 



UDDI (Universa! Description, 
Discovery and Integration ) è 
un protocollo, nato da un 
consorzio formato tra gli altri 
da Microsoft, IBM e Ariba, che 
permette di localizzare i web 
services di proprio interesse. 
In breve UDDI non è altro che 
un protocollo comune per la 
ricerca di Web Services, che ci 
può aiutare a trovare soluzioni 
in breve tempo e facendolo da 
un'unica e sola fonte. 
Più precisamente UDDI si 
suddivide in 3 differenti 
elenchi: 

• Pagine Bianche: 

contengono le informazioni 
anagrafiche delle imprese 
registrate 

• Pagine Gialle: attraverso 



l'utilizzo di opportune 
tassonomie (es: UN/SPSC) 
vengono descritti i prodotti 
ed i servizi offerti 

• Pagine Verdi: esplicitano i 
termini tecnici attraverso i 
quali basare lo scambio 
informativo diretto tra i 
partner. 

A questo riguardo consiglio 
due siti che ogni sviluppatore 
e/o utilizzatore di web service 
non può esimersi dal 
consultare: il primo è 
http://www.uddi.org/, che è il 
sito ufficiale del consorzio ed il 
sito http://www.xmethods.org/ 
che rappresenta un ottimo 
motore di ricerca per chi voglia 
trovare i web service adatti 
alle proprie applicazioni. 
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OleDb.OleDbConnection(strConnect) 



Try 



objConn. OpenQ 



Dim objcommand As New 

OleDb.OleDbCommand(strSql, objConn) 
Dim oAdapter As New 

OleDb.OleDbDataAdapter(objcommand) 

oAdapter. TableMappings.Add( 

"Table", "TableO") 



oAdapter. Fill(oDataSet) 



Catch ex As Exception 



Throw New Exception(ex.Message, ex) 



Finally 



objConn.Close() 



End Try 



Return oDataSet 



End Function 



nel nostro caso sarà: http://localhost Mercurio- 
WS_GestioneDB/Servicel.asmx. 
A questo punto dobbiamo avere una situazione 
del progetto simile a quella riportata in Figura 4. 
Il nostro client prevede una finestra principale 
che permette di effettuare operazioni di ricerca e 
di visualizzare i dati ricevuti dal web service. 
Quest'ultima operazione può essere compiuta 
grazie al seguente codice: 

Private Sub query(ByVal command As String) 
Dim ws As New GestioneDB.Servicel 
Dim ds As System. Data. DataSet = 

ws.query(command, Me.connect) 
DataGridl.SetDataBinding(ds, "TableO") 

DataGridl.RefreshQ 

End Sub 



Come si può notare il web method in questione 
riceve una stringa di connessione al database ed 
il comando SQL da eseguire. Grazie ad ADO pos- 
siamo poi effettuare la query e restituire il data- 
set. Possiamo anche prevedere un metodo che 
esegua un INSERT od un UPDATE invece che una 
query, in questo caso abbiamo: 

<WebMethod()> 

Public Function nonQuery(ByVal command As 

String, ByVal strConnect As String) As Integer 
Dim objConn As New 

OleDb.OleDbConnection(strConnect) 
Try 

objConn. Open() 

Dim objcommand As New 

OleDb.OleDbCommand(command, objConn) 
Return objcommand. ExecuteNonQuery 
Catch ex As Exception 

Throw New Exception(ex.Message, ex) 
Finally 



1 chiusa connessione 



objConn. CloseQ 



End Try 



End Function 

Naturalmente il parametro restituito questa volta 
sarà il numero di record coinvolti nel comando. 



DAL LATO DEL CLIENT 

Come abbiamo visto il nostro web service con 
poche righe di codice è già pronto per essere 
usato da una qualsiasi applicazione client, cosa 
che ci accingeremo immediatamente a fare. 
Dopo aver aver iniziato un nuovo progetto di tipo 
Windows Application dovremo aggiungere una 
web reference proprio come se si trattasse di una 
libreria esterna. L'indirizzo che ci verrà chiesto 



Come potete notare non si è fatto altro che istan- 
ziare un oggetto del nostro web service per poi 
chiamare il web method opportuno. 
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Fig.6: Una forni per gli ordini 

Il comando SQL viene generato da un'altra fine- 
stra come quella riportata in Figura 6, natural- 
mente potete inventarvi tutte le form che ritene- 
te più opportune. 

La creazione del comando sql può essere effet- 
tuato come segue: 



sqlCommand As String = "SELECT 


* FROM Ordini 


WHERE Ordini. IDCliente LIKE "' 




sqlCommand += TextBoxl.Text & 


'%'" 



CONCLUSIONI 

Con questo articolo spero di aver suscitato il 
vostro interesse e la vostra curiosità nei riguardi 
di questo tipo di tecnologia e di essere riuscito a 
dimostrare come ormai i web service siamo alla 
portata di chiunque. 
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MICROSOFT MESSAGE 
QUEUE PROGRAMMING 

ABBIAMO VISTO NEL NUMERO PRECEDENTE UNA OVERVIEW ARCHITETTURALE 
DEL PRODOTTO. IN QUESTO ARTICOLO VEDREMO MSMQ ALL'OPERA UTILIZZANDO 
LE VARIE OPZIONI DI DELIVERY 




Nell'articolo precedente (MSMQ: Overview 
Architetturale) abbiamo cercato di chiarire 
con due esempi il ruolo di un sistema di 
messaggistica applicativa asincrona per poi veder- 
ne la forma più semplice di invio e ricezione di un 
messaggio tramite le classi .NET che sfruttano 
Microsoft Message Queue. In questo articolo prose- 
guiamo con vari esempi applicativi che utilizzano le 
diverse opzioni che MSMQ mette a disposizione. 
Prima di iniziare è bene ricordare che l'applicazione 
sender non necessità di code definite in locale per 
appoggiare i messaggi quando non è connessa; l'ap- 
plicazione sender scrive sempre direttamente in 
una coda remota senza preoccuparsi della connetti- 
vità verso la coda. MSMQ tiene il messaggio in loca- 
le (in una coda di sistema) per poi spedirlo nella 
coda remota appena ritrovata la connettività: non 
occorre quindi definire una coda locale sul palmare 
dell'agente commerciale visto nell'articolo prece- 
dente; l'applicazione scriverà sempre nella coda 
aziendale e sarà MSMQ ad incaricarsi della spedi- 
zione non appena il palmare sarà connesso alla 
struttura aziendale. Partiamo subito con un esem- 
pio che andremo a commentare nelle varie sezioni: 



using System. Messaging; 



MessageBox.Show("Errore invio"); 



PRIORITÀ DEI MESSAGGI 

L'esempio di codice è identico a quanto mostrato 
nell'articolo precedente con alcune differenze che 
consentono di sfruttare le opzioni di delivery dispo- 
nibili. Come abbiamo accennato è possibile dare 
una priorità ai messaggi: è disponibile l'enum 
System.Messaging.MessagePriority per impostare la 
priorità al messaggio; in ordine di "priorità" le 
opzioni disponibili sono Highest, VeryHigh, High, 
AboveNormal, Normal, Low, VeryLow, Lowest. È bene 
ribadire che la priorità non è assoluta: non è assolu- 
tamente detto che un messaggio a priorità bassa sia 
letto (ricevuto dal receiver) dopo un messaggio con 
priorità alta. Il motivo è semplice: se un'applicazio- 
ne spedisce un messaggio a priorità bassa e subito 
dopo un messaggio a priorità alta e l'applicazione 
receiver è libera (e esiste connettività verso la coda) 
riceverà subito il messaggio a priorità bassa che sarà 
processato prima del messaggio successivo. 
Ricordatevi che questo non rappresenta un proble- 
ma. . . anzi! 




REQUISITI 



■ min M li iiii ^m 

9 Architettura di MSMQ. 
Si veda ioProgrammo 
N°101 



£ 



.NET Framework 1.x o 
2.0 per testare il codice 
presentato 



sisis ^j^ 



try 



using(MessageQueue mq = new MessageQueue( 

"@gondor\private$\testmsmq")) 



{ 



Message messaggio = new Message(); 
messaggio. Body = "Ciao dal Sender"; 
messaggio. Priority = MessagePriority.High; 



messaggio. Recoverable = true; 



mq.Send(messaggio); 



} 



MessageBox.Show("Inviato!"); 



} 



catch (MessageQueueException ex) 



{ 



MESSAGGI RECOVERABLE 

La seconda proprietà utilizzata nell'esempio è 
Recoverable. Un messaggio non recoverable (il 
default) viene tenuto in RAM dalla macchina che lo 
deve inviare verso la coda di destinazione e da tutte 
le macchine che agiscono da router verso la coda di 
destinazione (un server MSMQ può agire da MSMQ 
Router per instradare il messaggio in configurazioni 
di rete complesse). Questo significa che se una di 
queste macchine va in crash, oppure il servizio 
MSMQ viene riavviato oppure più semplicemente si 
fa un reboot della macchina, il messaggio (anzi i 
messaggi) "normali" vengono persi e quindi non 
spediti verso la coda di destinazione. L'impostazio- 
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ne di default è utile per tutte le applicazioni che, ad 
esempio, devono avvertire un'applicazione receiver 
in tempi ragionevoli sullo stato applicativo. L'esem- 
pio più classico è in campo industriale: molto spes- 
so le varie macchine di produzione inviano il loro 
stato a applicazioni che tramite gauge, indicatori di 
livello, grafici, mostrano queste informazioni ad un 
operatore a video. MSMQ potrebbe essere un ottimo 
sistema per far colloquiare il software della macchi- 
na di produzione con l'applicazione di monitorag- 
gio. Se la connettività fra le macchine viene interrot- 
ta o, più semplicemente, viene riavviato il PC della 
macchina industriale è inutile tenere i messaggi 
informativi perché non avrebbero più significato 
passato il tempo necessario al reboot. In tutti gli 
ambiti in cui è importante che tutti i messaggi spe- 
diti vengano recapitati a destinazione (e sono sicu- 
ramente più frequenti gli scenari in cui questo com- 
portamento è necessario rispetto all'esempio prece- 
dente) è possibile impostare la proprietà Recovera- 
ble a true per fare in modo che le macchine coinvol- 
te nella spedizione del messaggio verso la coda di 
destinazione appoggino i messaggi stessi su disco. 
Com'è intuibile i messaggi Recoverable sopravvivo- 
no ai reboot, ai crash applicativi e ai restart dei ser- 
vizi di Message Queue. È altrettanto ovvio che la spe- 
dizione sarà un minimo più lenta e consumi più 
risorse rispetto ai messaggi Recoverable-false. Anco- 
ra una volta MSMQ fornisce l'infrastruttura necessa- 
ria per gestire entrambe le problematiche senza do- 
ver scrivere codice complesso per raggiungere que- 
sti obiettivi. 



TIMEOUT IMPOSTABILI 

Complichiamo ancora un attimo l'esempio: 



using System. Messaging; 



try 



using(MessageQueue mq = new MessageQueue( 

"@gondor\private$\testmsmq")) 

{ 

Message messaggio = new Message(); 
messaggio. Body = "Ciao dal Sender"; 
messaggio. Priority = MessagePriority.High; 
messaggio. Recoverable = true; 
messaggio.TimeToReachQueue = 

TimeSpan.FromMinutes(lO); 
messaggio.TimeToBeReceive = 

TimeSpan.FromMinutes(20); 
mq.Send(messaggio); 

} 

MessageBox.Show("Inviato!"); 



catch (MessageQueueException ex) 



{ 



MessageBox.Show("Errore invio"); 



} 



Le ultime due proprietà impostate sull'oggetto mes- 
saggio nel codice precedente consentono invece di 
marcare il messaggio con due attributi utilissimi 
ancora una volta nell'esempio citato dell'automa- 
zione industriale: i messaggi di stato delle macchine 
che vengono inviati all'applicazione di monitorag- 
gio hanno un senso se visualizzati entro un certo 
periodo di tempo. Con la proprietà TimeToReach- 
Queue si indica il tempo, in secondi, che il messag- 
gio può impiegare per raggiungere la coda di desti- 
nazione: in pratica il tempo valido entro cui il mes- 
saggio ha senso che venga spedito nella coda di de- 
stinazione. Proviamo a chiarire con un altro esem- 
pio: un'applicazione che monitorizza le quotazioni 
di borsa invia al database che poi alimenta il sito 
pubblico consultabile dai clienti aggiornando le 
quotazioni ogni 10 minuti. È assolutamente inutile 
inviare i messaggi con le quotazioni delle ore 13:00, 
13:10, 13:20, 13:30 se la connettività fra l'applicazio- 
ne di monitoraggio e il sito web si interrompe dalle 
13:05 alle 13:54. Se ogni messaggio con la quotazio- 
ne di un titolo ha la proprietà TimeToReachQueue 
impostata allo scadere dei dieci minuti successivi 
(TimeSpan.FromMinutes(lO)) MSMQ eviterà di spe- 
dire messaggi "inutili" al sito web. La seconda pro- 
prietà (TimeToBeReceived), consente invece di im- 
postare la validità temporale del messaggio stesso; il 
significato è il seguente: è inutile che l'applicazione 
Receeiver legga un messaggio se sono passati più di 
X minuti, secondi, ore etc da quando è stato creato. 
In poche parole l'applicazione Sender indica entro 
quando il messaggio deve essere letto dall'applica- 
zione Receiver. È inutile dire che questa impostazio- 
ne viene utilizzata più frequentemente rispetto alla 
precedente in quanto molto spesso si pensa a qual è 
il tempo massimo di vita di un messaggio. Per torna- 



MICROSOFT MESSAGE QUEUE 




Per chi avesse perso la puntata 
precedente è bene ricordare che 
MSMQ è il servizio di Microsoft 
che consente di inviare messaggi 
da una macchina ad un altra 
tramite un sistema di code 
asincrono. In sostanza è possibile 
sviluppare un software che 
utilizza un sistema di 
comunicazione simile a quello 
delle segreterie telefoniche. 
L'esempio più classico di utilizzo è 
quello dell 'ecommerce. Un cliente 
effettua un pagamento su un sito 



web con carta di credito, la 
connessione con la banca è 
assente, la soluzione classica 
sarebbe quella di mostrare un 
messaggio d'errore all'utente, la 
soluzione con MSMQ prevede che 
la transazione venga mantenuta 
in una coda e che essa venga 
iniziata non appena la 
connessione con la banca viene 
ripristinata, inviando poi in modo 
asincrono una mail al cliente 
avvertendolo che il pagamento è 
avvenuto correttamente. 
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t 



è 



CODICE CHIARO 

In tutti gli esempi di 

questi due primi 

articoli viene utilizzata 

la modalità più 

semplice di scrittura 

codice per rendere 

tutto più chiaro. 

Infatti non vengono 

usati componenti 

helper o dll esterne per 

centralizzare le righe di 

codice per la 

spedizione dei 

messaggi. Ovviamente 

per le applicazioni reali 

conviene sempre 

crearsi la propria 

libreria helper per 

centralizzare il codice 

che utilizza le classi del 

namespace 

System. Messaging 

esattamente come si fa 

per l'accesso ai dati. 



re all'esempio specifico dell'automazione industria- 
le citato precedentemente, oltre alla proprietà 
Recoverable impostata a false, si imposterà su ogni 
messaggio il tempo in cui il valore di stato della 
macchina di produzione ha un senso. La proprietà 
TimeToReachQueue sembra che non abbia senso: in 
realtà è utilissima per non appesantire il sistema con 
la trasmissione di messaggi che non hano senso. 
Molto spesso infatti i due timeout vengono imposta- 
ti allo stesso valore. In termini funzionali un mes- 
saggio che non ha raggiunto la coda di destinazione 
entro il TimeToReachQueue viene cancellato auto- 
maticamente da MSMQ dalla sua coda di spedizio- 
ne interna. Un messaggio che, anche se avesse rag- 
giunto la coda di destinazione, non venga letto entro 
il tempo impostato con TimeToBeReceived viene 
anch'esso cancellato dalla coda di destinazione. 
Dovrebbe risultare ovvio che un messaggio scaduto 
come TimeToBeReceived non inizi la sua corsa verso 
la coda di destinazione e che il TimeToBeReceived 
non ha senso venga impostato a un valore inferiore 
rispetto a TimeToReachQueue. 



JOURNALING 
E DEAD-LETTER 

Se iniziamo a lavorare con i parametri di delivery 
appena accennati per uno scenario applicativo è 
probabile che lo scenario stesso ci imponga un con- 
trollo sui messaggi spediti, i messaggi positivamente 
recapitati (i messaggi arrivati e/o letti) e i messaggi 
non spediti (per timeout) o non letti (entro il ti- 
meout). Fortunatamente tutte queste opzioni sono 
contemplate dai servizi esposti da MSMQ. È impor- 
tante sottolineare da subito, però, che tutte queste 
opzioni forniscono informazioni sui messaggi spe- 
diti, non spediti, non ricevuti, letti, ma non ci danno 
nessuna informazione sull'esito dell'operazione fat- 
ta dal receiver sul messaggio stesso: il passaggio suc- 
cessivo sarà infatti quello di ottenere una risposta da 
parte del Receiver sull'esito dell'operazione che lui 
stesso ha compiuto in base al contenuto del mes- 
saggio. Procediamo con ordine. Se vogliamo tenere 
traccia di tutti i messaggi spediti è possibile abilitare 
ù Journaling. Ogni coda creata in MSMQ ha un gior- 
nale di bordo dove può essere tenuta una copia di 
tutti i messaggi recapitati nella coda stessa. È possi- 
bile decidere per ogni messaggio, tramite la pro- 
prietà UseJournalQueue, se duplicarne il contenuto 
nel giornale di bordo. Inoltre ogni macchina MSMQ 
di tipo server o di tipo Indipendent client ha una 
coda di sistema che si trova sotto System Queues 
denominata Journal Messages dove tenere una 
copia di tutti i messaggi transitati dalla macchina. Si 
può abilitare il journaling per ogni messaggio tra- 
mite la proprietà indicata oppure definire il journa- 
ling a livello di coda: per ogni coda, dalla maschera 



delle proprietà. Inoltre è possibile limitare la dimen- 
sione del giornale di bordo in KB per evitare una cre- 
scita illimitata: è bene ricordare che se si usa il jour- 
naling a livello di coda ogni messaggio ricevuto vie- 
ne anche copiato nel giornale di bordo quindi po- 
tenzialmente si può arrivare a diversi GigaBytes in 
poco tempo se i messaggi transitati sono molti e/o la 
loro dimensione è notevole. La seconda opzione per 
tracciare i messaggi è abilitare, tramite la proprietà 
UseDeadLetterQueue l'utilizzo di una coda di siste- 
ma dove recapitare tutti i messaggi impossibili da 
spedire. Ad esempio se per un messaggio scade il 
tempo impostato per raggiungere la coda di destina- 
zione (TimeToReachQueue), sulla macchina del- 
l'applicazione Sender verrà copiato il messaggio 
nella coda di sistema identificabile con il nome di 
Dead-Letter Messages. Dall'interfaccia di ammini- 
strazione o da codice è possibile aprire tale coda per 
ispezionarne il contenuto e quindi sapere quali e/o 
quanti messaggi non sono stati recapitati. 



ADMIMISTRATIOni QUEUE 

Volendo avere più controllo sull'esito dell'invio dei 
messaggi, oltre alle due tecniche appena citate 
(Journaling e Dead-Letter) si può impostare sul 
singolo messaggio la proprietà AcknoledgeType e la 
proprietà AdministrationQueue. La seconda pro- 
prietà indica una coda, definita dall'applicazione, 
dove recapitare l'esito di invio di ogni messaggio. In 
pratica, tramite l'abilitazione del journal avviene 
una copia del messaggio nel giornale di bordo, tra- 
mite l'utilizzo della dead-letter è possibile identifica- 
re i messaggi non recapitati, tramite l'impostazione 
della coda amministrativa (AdministrationQueue) 
è possibile indicare per ogni messaggio dove il mo- 
tore di MSMQ debba recapitare una copia del mes- 
saggio stesso contenente anche l'esito dell'operazio- 
ne. Vediamo il codice per chiarirci le idee: 



using System. Messaging; 



try 



using(MessageQueue mq = new MessageQueue( 

@"gondor\private$\testmsmq")) 

{ 

Message messaggio = new Message(); 
messaggio. Body = "Ciao dal Sender"; 
messaggio. Priority = MessagePriority.High; 
messaggio. Recoverable = true; 
messaggio.TimeToReachQueue = 

TimeSpan.FromMinutes(lO); 
messaggio.TimeToBeReceive = 

TimeSpan.FromMinutes(20); 
messaggio. AdministrationQueue = new 
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MessageQueue(@"nomemacchina\private$ 
\testmsmqAdminQueue"); 
messaggio.AcknowledgeType = 

AcknowledgeTypes.FulIReceive; 
mq.Send(messaggio); 



} 



MessageBox.Show("Inviato!"); 



} 



catch (MessageQueueException ex) 



{ 



MessageBox.Show("Errore invio"); 



} 



Con il codice presentato è possibile indicare a 
MSMQ che dovrà recapitare un messaggio di ackno- 
ledgement per il nostro messaggio nella coda 
"testmsmqAdminQueue" (ovviamente la coda deve 
esistere). Nel nostro caso stiamo chiedendo un Full- 
Receive, cioè vogliamo sapere se il messaggio è arri- 
vato a destinazione ed è stato letto dall'applicazione 
receiver. 

L'enum System.MessagingAcknowledgeTypes con- 
sente di indicare: 

1) FullReachQueue 

2) FullReceive 

3) NegativeReceive 

4) None 

5) NotAcknowledgeReachQueue 

6) NotAcknowledgeReceive 

7) PositiveArrival 

8) PositveReceive 

Senza dilungarsi nel significato di ognuna di queste 
impostazioni, facilmente identificabili nell'help sot- 
to l'enum System. MessagingAcknowledgeTypes, è 
importante capire che gli ultimi due indicano che 
vogliamo ricevere il messaggio, nella coda ammini- 
strativa indicata da codice, per sapere rispettiva- 
mente se il messaggio è arrivato nella coda di desti- 
nazione o è stato ricevuto dall'applicazione receiver. 
NegativeReceive indica che vogliamo sapere se il 
messaggio non è stato ricevuto, FullReceive indica 
che vogliamo sapere "tutto", vale a dire se il messag- 
gio è stato ricevuto dall'applicazione receiver oppu- 
re se non è stato ricevuto dall'applicazione receiver. 
La coda amministrativa è una coda a tutti gli effetti, 
quindi si possono utilizzare tutti i metodi utilizzabi- 
li per qualunque coda: Receive, GetAllMessages, 
GetMessageEnumerator, Exist, Create e così via. Il 
messaggio recuperato con Receive (come un nor- 
male messaggio in una coda) espone la proprietà 
Acknowledgement con la quale è possibile capire 
cosa è successo al messaggio. Ancora una volta è di- 
sponibile l'enum System.MessagingAcknowled-ge- 
mentper capire meglio il tipo di ack ricevuto. Reach- 
Queue indica che il messaggio ha raggiunto la coda 
di destinazione, ReachQueueTimeout indica invece 
che è scaduto il timeout indicato {TimeToReach- 



Queue) per raggiungere la coda e quindi il messag- 
gio non è stato recapitato. Receive indica che il mes- 
saggio ha avuto una receive positiva da parte del- 
l'applicazione Receiver, mentre ReceiveTimeout in- 
dica che il messaggio non è stato ricevuto in quanto 
è scaduto il timeout impostato per la ricezione {Ti- 
meToBeReceived) . 



RESPOMSE QUEUE 

Come abbiamo accennato all'inizio dell'articolo, è 
importante sapere che tutte le opzioni citate fino ad 
adesso forniscono informazioni sui messaggi spedi- 
ti, non spediti, non ricevuti, letti, ma non ci danno 
nessuna informazione sull'esito dell'operazione 
fatta dal receiver sul messaggio stesso. L'ultimo pas- 
saggio di questo articolo è ottenere una risposta da 
parte del Receiver sull'esito dell'operazione che lui 
stesso ha compiuto in base al contenuto del mes- 
saggio. Tramite questa risposta è possibile prendere 
provvedimenti come ad esempio avvertire l'utente 
che l'operazione che lui aveva (il passato è d'obbli- 
go) tentato di fare (notare la parola "tentato") non è 
andata a buon fine. 

Vediamo il codice dell'applicazione sender e dell'ap- 
plicazione receiver per poi commentarli 



using Sy sterri. Messaging; 



try 



using(MessageQueue mq = new 
MessageQueue("@gondor\private$\testmsmq")) 

{ 

Message messaggio = new Message(); 
messaggio. Body = "Ciao dal Sender"; 
messaggio. ResponseQueue = new 
MessageQueue("@PEPPE\private$\testmsmqResponse"); 
mq.Send(messaggio); 

} 

MessageBox.Show("Inviato!"); 

_> 

catch (MessageQueueException ex) 

S 

MessageBox.Show("Errore invio"); 

} 

Solitamente l'applicazione sender indica, tramite la 
proprietà ResponseQueue del messaggio dove vor- 
rebbe che venissero recapitate le risposte sull'esito 
dell'operazione. È probabile che la coda di risposta 
stia sulla stessa macchina dell'applicazione sender: 
ad esempio, nello scenario dell'agente esterno che 
prende ordini con il palmare è probabile che l'appli- 
cazione sender sul palmare debba essere informata 
quando non è possibile creare un ordine per il clien- 
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te, quindi l'applicazione sender indicherà come 
ResponseQueue una coda locale sul palmare dove 
recapitare i messaggi. L'applicazione receiver analiz- 
za il messaggio in ingresso, prova a creare un ordine 
e in caso negativo utilizzerà la coda (sotto forma di 
proprietà del messaggio ricevuto) per inviare un 
messaggio che indica al sender "la richiesta di ordi- 
ne xyz non è stata processata" e possibilmente i 
motivi del rifiuto (il cliente non ha pagato le ultime 
fatture... caso classico). In questo caso il codice del 
sender potrebbe essere rivisto in questo modo: 



using Sy sterri. Messaging; 



try 



using(MessageQueue mq = new 

MessageQueue("@gondor\private$\testmsmq")) 

J 

Message messaggio = new Message(); 
messaggio. Body = "Ciao dal Sender"; 



messaggio. ResponseQueue = new 



MessageQueue("@NomeClient\private$\ 

testmsmqResponse"); 



mq.Send(messaggio); 



} 



MessageBox.Show("Inviato!"); 



} 



catch (MessageQueueException ex) 



{ 



MessageBox.Show(" Errore invio"); 



> 



Ovvero il codice sul palmare recupera dimanica- 
mente il nome del device per formare la stringa che 
rappresenta la coda di risposta: in questo modo il 
codice è indipendente dal device su cui gira. 
L'applicazione Receiver invierà un messaggio di 
risposta sulla coda indicata dal client. Rimanendo 
sull'esempio semplice di invio di stringa nel body, 
ecco il codice dell'applicazione Receiver : 



using System. Messaging; 



try 



using(MessageQueue mq = new MessageQueue( 

"@gondor\private$\testmsmq")) 

J 

mq.Formatter = new XmlMessageFormatter( 

new Type[] { typeof(String) }); 
// Ricezione del messaggio 
Message messageReceived = mq.Receive(); 
String contenuto = 

(String)messageReceived.Body; 
// Processo il contenuto del messaggio... 



// Supponiamo non si possa fare l'operazione 



// Inviamo risposta al mittente 



try 



using(MessageQueue mq = new 

MessageQueue( 
messageReceived . ResponseQueue)) 



{ 



Message messaggio = new Message(); 
messaggio. Body = "Risposta negativa al 

messaggio " + messageReceived. Id; 



mq.Send(messaggio); 



} 



MessageBox.Show("Inviato!"); 



} 



catch (MessageQueueException ex) 



{ 



MessageBox.Show("Errore invio risposta"); 



} > 



} 



catch (MessageQueueException ex) 



{ 



MessageBox.Show("Errore ricezione messaggio"); 



} 



Nel codice precedente, l'applicazione Receiver, ten- 
ta di eseguire l'operazione e, in caso negativo, recu- 
pera dal messaggio la coda indicata [messageRe- 
ceived.ResponseQueué) per la risposta; tramite gli 
stessi oggetti usati dal sender invia un messaggio 
nella coda indicata. Anche il receiver può utilizzare 
tutte le proprietà viste in questo articolo per sapere 
l'esito del messaggio di risposta: ad esempio può in- 
dicare un AcknoledgeType, un TimeToReachQueue e 
così via. La proprietà Id viene solitamente inviata 
nella risposta per indicare al client a quale messag- 
gio si riferisce la risposta. Nello scenario che ci por- 
tiamo dietro dal primo articolo, il receiver potrebbe 
confezionare una risposta che riporta il numero di 
"Richiesta Ordine" rifiutata senza usare la proprietà 
Id. In altri scenari la coda di risposta è fissa e viene 
appoggiata su una macchina dove magari risiede 
un'applicazione preposta ad analizzare le risposte 
negative o positive dell'applicazione receiver e 
magari informa via mail chi di dovere. In questo 
caso il sender non compilerà la ResponseQueue che 
probabilmente verrà letta dall'applicazione Receiver 
da un file di configurazione locale. 



CONCLUSIONI 

MSMQ rappresenta uno strumento estrema- 
mente scalare per la cessione di code di messag- 
gi e si pone come nodo centrale nella comunica- 
zione asincrona. 

Roberto Brunetti 
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BEANSHELL SCRIPTING: 
ESTENDIAMO JAVA 

IN MOLTISSIMI SCENARI LA PRESENZA DI UN LINGUAGGIO NON COMPILATO PUÒ 
RAPPRESENTARE UNA RISORSA CHE CONSENTE ALL'UTENTE DI PERSONALIZZARE 
L'APPLICAZIONE SENZA DOVER COMPIERE SFORZI NOTEVOLI. UTILIZZIAMO QUESTA TECNICA. 
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Spesso esistono stringenti requisiti di rapidità 
nello sviluppo. Un aiuto può derivare dall'in- 
corporare un motore di scripting all'interno di 
Java. Nell'articolo approfondiremo la soluzione pro- 
posta da BeanShell. Un linguaggio di scripting, 
quale PHR JavaScript o lo stesso BeanShell presenta- 
to in questo articolo, si differenzia da un linguaggio 
compilato come Java per due principali ragioni: il 
modo in cui un programma viene eseguito e la tipiz- 
zazione delle variabili. Per quanto riguarda l'esecu- 
zione, i linguaggi di scripting prevedono solitamen- 
te un'esecuzione tramite interprete. Questo compo- 
nente software analizza il sorgente e ne esegue le 
varie istruzioni passo passo. I programmi scritti con 
linguaggi compilati devono invece essere trattati da 
un compilatore che produce un codice eseguibile 
direttamente da un processore fisico, come nel caso 
di C, o da una sorta di processore emulato via 
software, come avviene ad esempio con la macchina 
virtuale Java. Questa differenza è nella maggior 
parte dei casi di poca importanza per il programma- 
tore, se non in relazione alla velocità d'esecuzione, 
ma la stessa cosa non si può certo dire della questio- 
ne della tipizzazione delle variabili. In un linguaggio 
tipizzato è necessario dichiarare il tipo di ogni varia- 
bile utilizzata. Con queste informazioni il compila- 
tore è in grado di controllare che le variabili siano 
utilizzate in modo consistente. Ad esempio se una 
funzione prevede un parametro di tipo intero ma in 
una chiamata è passato come parametro una varia- 
bile di tipo stringa, il compilatore rileva l'incon- 
gruenza, interrompere la compilazione ed avverte il 
programmatore. Nei linguaggi di scripting invece 
non sempre è necessario dichiarare una variabile 
prima di utilizzarla ed è possibile assegnarle valori di 
volta in volta di tipo differente: interi, stringhe, date, 
riferimenti ad oggetti, senza alcuna limitazione. 
Questa caratteristica permette di rinunciare a molto 
del formalismo imposto dai linguaggi compilati, 
permettendo sicuramente un avvio e una realizza- 
zione più rapida di progetti di piccole dimensioni. 
Molti lettori avranno avuto sicuramente la possibi- 
lità di verificare quanto possa essere tedioso e lento 
sviluppare un servizio web di dimensioni limitate 



con Java e quanto sia invece immediato e semplice 
implementarlo con PHP. I linguaggi interpretati 
offrono inoltre tempi di deploy notevolmente infe- 
riori. Un update di un servizio web realizzato con 
PHP si limita nella maggior parte dei casi ad un 
upload sul server della nuova versione del file sor- 
gente ove sia stata apportata la correzione, mentre 
un update di un servizio web basato su Java richiede 
in linea di massima la compilazione, la creazione 
degli archivi e il deploy degli stessi sul server. La 
forza dei linguaggi di scripting nei piccoli progetti 
diventa però la loro debolezza nello sviluppo di 
sistemi più complessi. La compilazione e la tipizza- 
zione difatti permettono di garantire la consistenza 
nelle assegnazioni delle variabili mentre con un lin- 
guaggio di scripting eventuali incongruenze si veri- 
ficano solo a runtime. L'ideale sarebbe un linguaggio 
che permetta di essere utilizzato contemporanea- 
mente come linguaggio compilato o come linguag- 
gio di scripting a seconda delle esigenze. BeanShell 
mira a soddisfare questo bisogno fornendo la possi- 
bilità di programmare in Java con un linguaggio di 
scripting. 



L'AMBIENTE DI LAVORO 

Collegatevi al sito http://www.beanshell.org/ e por- 
tatevi nella sezione "download". Da qui scaricate 
l'ultima versione di BeanShell che al momento della 
stesura dell'articolo è la 2. 0b4. Varie sono le distribu- 
zioni offerte: una contiene tutti gli elementi di 
BeanShell in un unico jarflle, mentre le altre offrono 
separatamente l'interprete e i vari componenti 
accessori. Per la realizzazione degli esempi proposti 
in questo articolo è consigliato l'utilizzo della libre- 
ria completa bsh-2.0b4.jar. Prima di avventurarci 
nell'utilizzo di BeanShell all'interno di un program- 
ma Java presentiamo qualche esempio. BeanShell 
viene fornito con un'interfaccia testuale all'interpre- 
te che permette di eseguire programmi stand alone. 
Fate partire l'interfaccia aprendo la console del si- 
stema operativo e digitando il seguente comando, 
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avendo cura di sostituire <path> con il percorso per 
raggiungere il fileyar di BeanShell appena scaricato. 

java -jar <path>\bsh-2.0b4.jar 

Si apre la finestra di BeanShell con un workspace 
attivo. Ciccate su "File > capture System inloutlerf 
per visualizzare nella finestra del workspace i mes- 
saggi prodotti dal programma che altrimenti sareb- 
bero visibili solo nella console del sistema operativo. 
A questo punto ciccate su "File > Workspace editor". 
Si aprirà un'altra finestra nella quale inseriremo i 
programmi BeanShell. 



VARIABILI Moni TIPIZZATE 

In Beanshell non è necessario dichiarare pre- 
ventivamente il tipo di una variabile, è sufficiente 
utilizzarla. Il sorgente BeanShell seguente da una 
prima idea della sintassi molto simile a quella di 
Java e mostra come possano essere usate variabili 
non tipizzate. 



a = 5.5; 

b = new Integer(5); 
print(a+b); 

a = "5.5"; 

b = "5"; 

print(a+b); 

a = new int[]{l,2,3}; 

print(a); 

Lanciamo il programma mediante la voce di menu 
"Evaluate > eval in workspace". L'output prodotto è: 



10.5 

5.55 

Come è possibile vedere dall'esempio precedente la 
variabile "b" è inizialmente di tipo Integer e poi di 
tipo String. Inoltre la prima somma viene calcolata 
tra un oggetto Integer ed un int. Nelle versioni di 
Java precedenti alla 1.5 sarebbe stato necessario 
convertire Y Integer in int mediante il metodo 
intValueO. BeanShell invece incorpora un meccani- 
smo di autoboxing che converte automaticamente i 
tipi wrapper come Boolean, Integer, Long nei 
corrispondenti tipi primitivi sin dalle prime ver- 
sioni. Nel secondo caso, essendo diventata "b" una 
stringa, la somma prende il significato di concate- 
nazione. 



UTILIZZO DI FUNZIONI 

Negli script BeanShell è ovviamente possibile 
utilizzare funzioni. L'esempio seguente mostra una 



funzione che calcola la somma degli elementi 
contenuti in un array di valori interi. 

sum(arr){ 
sum = 0; 
for(x=0; xorr.lenght; x++){ 



sum = sum + arr[x]; 



} 



values = new int[]{3,43,23,-12}; 



print(sum(values)); 

Lanciamo il programma mediante la voce di menu 
"Evaluate > eval in workspace". L'output prodotto è 
ovviamente 57. 



INTEGRARE 

JAVA E BEANSHELL 

Per vedere all'opera le potenzialità dell'integrazione 
tra Java e BeanShell sviluppiamo il core di quella 
che potrebbe essere un'applicazione reale. Una 
nuova catena di palestre richiede lo sviluppo di un 
sistema informativo per la gestione degli iscritti. In 
particolare il reparto marketing ha pensato di 
associare ad ogni cliente, per fidelizzarlo, un profilo 
tariffario che offra sconti sugli ingressi. Il commit- 
tente per presentarsi in maniera aggressiva sul mer- 
cato prevede di proporre ai clienti profili tariffari 
sempre diversi ed è assolutamente necessario che 
tali profili siano resi disponibili in tempi brevissimi. 
Riuscire a soddisfare i bisogni di immediatezza del 
cliente potrebbe essere difficoltoso utilizzando 
esclusivamente Java poiché si dovrebbe magari im- 
plementare una nuova classe per ogni nuovo profilo 
tariffario pensato dal reparto marketing, farne il 
deploy, e così via. Potrebbe essere una buona idea 
realizzare la funzionalità di calcolo del costo di 
ingresso del biglietto con BeanShell, associando 
ogni profilo un programma. Non essendo richiesta 
nessuna ricompilazione si potrebbero così rendere 
gestibili da sistema molte tariffe senza cambiare 
minimamente il codice compilato. 



STRUTTURA 
DELL'APPLICATIVO 

La classe Customer rappresenta il cliente della 
palestra ed ha associato un "profilo" tariffario che 
influenzerà il modo in cui il costo dei biglietti di 
ingresso è calcolato. Il cliente mantiene anche una 
lista di tutti i biglietti di ingresso che ha acquistato. 
In questo modo sarà semplice implementare profili 
tariffari che prevedono offerte basate sugli acquisti 
pregressi. La classe immutabile Ticket rappresenta il 
biglietto ed ha una data di validità e un prezzo. Il 
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prezzo dovrà essere calcolato in base al profilo del 
cliente che lo ha acquistato. Il costruttore è privato 
perché le istanze di Ticket saranno create tramite un 
metodo factory che calcolerà il prezzo in base al 
profilo dell'utente. Due getter permettono l'accesso 
alla data per cui il biglietto è valido e al prezzo. Il 
metodo toStringO utilizza SimpleDateFormat e De- 
cimalFormat per ottenere una descrizione del bi- 
glietto formattata in modo ordinato e più leggibile. 



entranceDate); 



tickets.add(newTicket); 



return newTicket; 



} 



public Ticket[] getTickets(){ 



return (Ticket[])tickets.toArray(new 



Ticket[tickets.size()]); 



} 



package it.ioprogrammo; 



import [...] 



import bsh.*; 



public class Ticket { 



private final Date entranceDate; 



private final doublé price; 



private Ticket(Date entranceDate, doublé price) { 



this. entranceDate = entranceDate; 



this. price = price; 



} 



public doublé getPrice(){return price;} 

public Date getEntranceDate(){return entranceDate;} 



public String toString(){ 



return 



"Entrance on " + new SimpleDateFormat( 

"MM/dd/yyyy").format(entranceDate) + " " + 
new DecimalFormat("€ ####.00").format(price); 



} 



La classe Customer rappresenta un cliente della 
catena di palestre. L'attributo profile memorizza il 
nome del profilo tariffario scelto dal cliente, mentre 
l'attributo tickets memorizza tutti i biglietti prece- 
dentemente acquistati in una List. Il metodo più 
significativo è newTicketQ invocato per ottenere il 
biglietto relativo al nuovo ingresso. Il codice utilizza 
il metodo factory Ticket. gè tTicketQ al quale passa 
un riferimento al Customer per il quale si sta 
chiedendo il biglietto di ingresso e la data per la 
quale lo si richiede. Queste informazioni sono 
passate in modo che il metodo factory possa 
calcolare il prezzo del biglietto avendo tutte le 
informazioni necessarie. 

package it.ioprogrammo; 
import java. util.*; 
public class Customer { 

private List tickets = new Array List(); 

private String profile = "default"; 

public void setProfile(String profile){ 
this. profile = profile; 

_} 

public String getProfile(){ 
return profile; 

_} 

public Ticket newTicket(Date entranceDate){ 
Ticket newTicket = Ticket. getTicket(this, 



IL CALCOLO DEL COSTO 
DEL BIGLIETTO 

Il metodo factory per i biglietti è implementato 
come metodo statico della classe Ticket. Viene 
istanziato un oggetto di tipo Interpreter, che è il 
componente in grado di leggere ed eseguire 
sorgenti BeanShell. Il primo passo è quello di 
caricare il programma BeanShell relativo al profilo 
tariffario scelto dal cliente. Per instaurare questa 
associazione si è decisa una semplice regola di 
naming. Il file sorgente BeanShell si trova nella 
directory it/ioprogrammo/ e ha come nome quello 
del profilo del cliente ed estensione .bsh. Così ad 
esempio per tutti i clienti con profilo tariffario 
uguale a "default", il sorgente BeanShell per il 
calcolo della tariffa si troverà nel file litlioprogram- 
mo/default.bsh. Poi sono valorizzate nell'interprete 
le variabili "basePrice" con il valore del biglietto di 
ingresso senza nessun particolare sconto e "tickets", 
un array con tutti i biglietti precedentemente 
acquistati dal cliente. A questo punto lo script il cui 
path è già stato definito viene caricato ed eseguito. 
Si noti che grazie al passo precedente lo script potrà 
utilizzare le variabili "basePrice" e "tickets" anche 
senza valorizzarle. Al termine dell'esecuzione dello 
script, lanciata tramite il metodo evalQ, il pro- 
gramma estrae il valore della variabile "ticketPrice" 
che lo script deve avere cura di valorizzare 
all'importo del biglietto proposto per il cliente. 
Questo prezzo viene poi assegnato al nuovo 
biglietto. 

public static Ticket getTicket( 

Customer e, Date entranceDate){ 
Interpreter i = new Interpreter(); 
Ticket ticket = nuli; 



try{ 



String resPath = "/it/ioprogrammo/" + c.getProfile() 

+ ".bsh"; 



i.setfbasePrice", 20.0); 



i.set("tickets", c.getTicketsQ); 



try{ 



.eval(new InputStreamReader( 

Ticket, class. getResourceAsStream( 
resPath ))); 



}catch(NullPointerException npe){ 
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throw new RuntimeException( 
resPath + " 


not found.' 


, npe); 


} 


doublé price = ((Double)i.get("ticketPrice") 

).doubleValue(); 


ticket = new Ticket(entranceDate, 


price); 




} catch ( Eva lError ea){ 


ea.printStackTrace(); 


} 


return ticket; 


} 



ticketDate.time=ticket.entranceDate; 



if(frequent==false){ 



frequent = ticketDate.after(oneWeekAgo); 



frequent = true; 



} 



return frequent; 



} 



ticketPrice = basePrice; 



if(thereIsRecentTicket()){ 



ticketPrice = ticketPrice * .8; 



} 




PROFILO TARIFFARIO 
DI DEFAULT 

Scriviamo ora il sorgente BeanShell che calcola il 
costo del biglietto per un cliente che ha il profilo 
"default" a cui non corrisponde nessuna applicazio- 
ne di sconti e salviamolo, seguendo la regola di 
naming definita, nel file "defaultbsh". Questo script 
si limiterà a restituire nella variabile ticketPrice il 
valore impostato in basePrice. 

ticketPrice = basePrice; 

Aggiungiamo un metodo main alla classe Custo- 
mer che ci permetta di simulare l'emissione di un 
biglietto. 



public static void main(String[] a){ 


Customer ci = new Customer(); 


Ticket ti = cl.newTicket(new Date()); 


System. out.println(tl); 


} 



Eseguimao il programma avendo cura di inserire nel 
classpath il jar di BeanShell. L'output dovrebbe esse- 
re il seguente. 



Alla variabile ticketPrice viene assegnato il prezzo 
base. Viene invocata la funzione therelsRecent- 
TicketQ che restituisce true se nell'ultima settimana 
è stato acquistato qualche biglietto. In caso affer- 
mativo il prezzo del biglietto diventa l'80% di quel- 
lo pieno. La funzione therelsRecentTicketQ utilizza 
un GregorianCalendar impostato ad una settimana 
fa per controllare che esista un biglietto acquistato 
dopo quel limite, scorrendo l'intero array di bigliet- 
ti che dal codice Java abbiamo preventivamente 
assegnato alla variabile "tickets". Si noti che nel sor- 
gente è utilizzata per il ciclo for la notazione com- 
patta "(var : array)" che valorizza automaticamente 
ad ogni giro la variabile 'Var" con uno degli elemen- 
ti di "array". Inoltre BeanShell mette a disposizione 
una notazione abbreviata per accedere alle pro- 
prietà di un oggetto normalmente accedute tramite 
i getter e i setter. 

Ad esempio nella funzione therelsRecentTicketQ è 
possibile notare l'istruzione 

ticketDate.time=ticket.entranceDate 

Che equivale a 

ticketDate.setTime(ticket.getEntranceDateQ); 



"Entrance on 01/20/2006 €20.00" 



PROFILO TARIFFARIO 
"FREQUENT" 

Implementiamo ora lo script per il profilo tariffario 
"frequent" che prevede uno sconto del 10% del prez- 
zo se nell'ultima settimana si è acquistato un altro 
biglietto. Il file contenente il sorgente si troverà 
quindi in "frequent.bsh". 

thereIsRecentTicket(){ 
oneWeekAgo = new GregorianCalendar(); 

oneWeekAgo.add(Calendar.WEEK_OF_YEAR, -1); 

ticketDate = new GregorianCalendar(); 
frequent = false; 
for(ticket : tickets){ 



Come ultima particolarità è da notare che benché 
nel sorgente BeanShell venga utilizzata la classe 
GregorianCalendar nei package java.util, quest'ulti- 
mo non è dichiarato in nessun import. Questo per- 
ché le classi di alcuni package spesso utilizzati quali 
java.util, java.net, javado e altri sono direttamente 
disponibili. 



CONCLUSIONI 

Aggiungere nuove politiche di sconto è quindi 
immediato utilizzando BeanShell. È difatti sufficien- 
te inserire un nuovo script. È da notare che non è 
nemmeno necessario ricompilare alcunché perché 
ogni volta che verrà calcolato il costo lo script sarà 
rieseguito. 

Daniele De Michelis 
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PRIMI PASSI 
CON NHIBERNATE 

IMPARIAMO A USARE UN FRAMEWORK DI PERSISTENZA CHE RISOLVE IL PROBLEMA 
DELLA CORRISPONDENZA FRA DATI SQL, CLASSI E OGGETTI. IL NOSTRO SCOPO SARÀ 
RENDERE IL CODICE PIÙ MANUTENIBILE E GESTIRE I DATI IN MODO SEMPLICE 




fi 




REQUISITI 



Conoscenze richieste 



Linguaggio C#, 
Microsoft SQL Server, 
nozioni di SQL 



i 



.NET Framework 1.1 o 
superiore, Microsoft 
SQL Server 2000 o 
superiore 



s^is 



Tempo di realizzazione 



0O 



uale programmatore non si è mai trovato in 
una situazione in cui il cliente ci costringe a 
rivedere completamente il nostro lavoro? 



1. Avete sviluppato il vostro software con logica 
object oriented e accesso ad un database trami- 
te il tradizionale SQL. 

2. Arriva la telefonata del cliente che vi chiede di 
stravolgere tutto il vostro progetto, addirittura 
dallo schema del database. 

3. Soluzione tradizionale: Modificare il database, 
cambiare tutte le classi, cambiare le statement 
SQL, ri- testare, ri-debuggare. . . e pregare che tut- 
to vada per il meglio! 

L'accesso ai dati è una parte fondamentale del no- 
stro codice: centinaia se non migliaia di codice da ri- 
vedere, riscrivere, testare, magari distribuito in nu- 
merosissimi punti del vostro software, difficilmente 
manutenibili. Tali istruzioni sono sempre piuttosto 
ripetitive da scrivere e pronte ad errori di scrittura 
identificabili nella maggior parte dei casi solo a run- 
time, poiché sono interpretate dal motore di databa- 
se e non dal nostro "buon" compilatore. La soluzio- 
ne a questi problemi esiste. . .Usiamo NHibernate! 



IL MODELLO THREE-TIER 

Ovviamente esistono metodologie per scrivere 
applicazioni in modo molto efficiente e controlla- 
to. Uno dei migliori pattern che quotidianamente 
viene usato nelle applicazioni enterprise è il three- 
tier (0 three-layer). Le applicazioni (solitamente 
distribuite) sviluppate secondo questa metodolo- 
gia presentano tre layer applicativi i cui ruoli sono 
nettamente distinti: un Presentation Layer che 
contiene la logica di presentazione, un layer inter- 
medio (Business Layer Service Layer) che contie- 
ne tutta la logica e la descrizione degli oggetti del 
dominio di business, e un layer totalmente dedica- 
to alla parte di accesso al database (Data Access 



Layer), cioè a quelle operazioni chiamate CRUD 
(Create, Read, Update, Delete) operazioni di per- 
sistenza che si occupano del lavoro sul database. 
Adesso concentriamoci su quest'ultimo layer. La 
divisione dell'applicazione in tier isola la parte di 
lavoro su database in uno strato applicativo dedi- 
cato e questo è sicuramente un bene, poiché per 
ogni modifica implementativa sappiamo di dover 
andare a mettere le mani in una porzione ristretta 
di progetto. Ma si può e si deve andare oltre. Visto 
allora che le operazioni sui dati molte volte sono 
così ripetitive esiste un modo per automatizzarle e 
renderci la vita più semplice? 



NASCONO GLI ORIVI 

Il mercato software assiste così alla nascita di 
numerosissimi framework che si occupano di 
automatizzare la persistenza degli oggetti di domi- 
nio, gli Objet Relational Mapping. Questi tool si 
occupano di mappare la rappresentazione di un 
oggetto di dominio (una classe .net) in una più 
righe di tabelle di database secondo il modello 
relazionale. La mancata corrispondenza dei due 
modelli di rappresentazione di dati {OOP e 
Relazionale) è peraltro nota nella letteratura infor- 
matica con il nome di Object Relational Mismatch 
(link) . E così nasce NHibernate: il porting su archi- 
tettura .NET del conosciutissimo Hibernate del 
mondo Java, il framework di persistenza più famo- 
so e usato al mondo che rappresenta lo standard 
de facto per gli sviluppatori di applicazioni con 
accesso ai dati, recentemente acquisito dalla JBoss 
Ine (link). Il tutto rigorosamente OpenSource. 



L'IMPORTANZA 

DEL DOMAIN MODEL 

Uno dei guru mondiali di architetture software, 
Martin Fowler, autore peraltro di libri che sono 
pietre miliari nella letteratura informatica mon- 
diale, ci da un grande suggerimento su come 
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affrontare e risolvere problemi di business: il 
"Domain Model Pattern". Una rete di oggetti inter- 
connessi ciascuno dei quali ha un proprio scopo di 
business, contenenti contemporaneamente sia i 
dati che la logica di comportamento. 
Esempio: un sotware bancario avrà quindi un do- 
main model costituito da classi tipo Cliente, Con- 
toCorrente, Bonifico, Giroconto. Nella progettazio- 
ne di queste classi, inoltre, per sfruttare al massi- 
mo le possibilità offerte dal design orientato agli 
oggetti, dobbiamo utilizzare, ove possibile, carat- 
teristiche quali ereditarietà e polimorfismo. Ci 
ritroveremo per esempio ad avere una classe 
Bonifico che funge da base da cui ereditano Boni- 
ficolnter nazionale, e BonificoNazionale, magari 
con comportamento polimorfico su alcune fun- 
zioni virtuali e così via. Lo studio del nostro 
domain model non deve essere contaminato dalla 
modalità con cui i nostri oggetti di dominio saran- 
no resi persistenti sul database. Il disegno del da- 
tabase deve essere fatto a prescindere dal modello 
di dominio, poiché si baserà su un modello rela- 
zionale che manca di concetti come l'ereditarietà 
o il polimorfismo. E qui si incastrano perfettamen- 
te gli ORM e NHibernate in particolare, aiutando 
lo sviluppatore a pensare al suo software prin- 
cipalmente in termini di domain model, e fornen- 
do strumenti eccellenti per quello che riguarda la 
parte di trasformazione di questi oggetti di domi- 
nio in righe di database. Pensare al vostro domain 
model in modo staccato rispetto a come questo 
sarà persistito migliorerà drasticamente la qualità 
del vostro codice. Gli ORM inoltre danno una mar- 
cia fondamentale in più. L'indipendenza dal tipo 
di database utilizzato. Nel caso di NHibernate 
basta cambiare una riga di configurazione esterna 
al codice per far lavorare un'applicazione che 
prima girava su SQL Server, in Oracle, o MySQL o 
tanti altri. Impareremo a liberarci delle istruzioni 
SQL cablate nel codice! 



MA NON C'ERANO 
I DATASET? 

La Microsoft fin dall'introduzione di .NET ha 
appoggiato l'uso dei suoi Dataset come ponte tra il 
database e i layer di business logie. Ma chi ben 
conosce i dataset sa perfettamente che sono terri- 
bilmente limitati per descrivere il modello di 
Dominio di una qualsiasi applicazione: non è pos- 
sibile usare paradigmi OOP come polimorfismo, 
ereditarietà, e soprattutto siamo costretti a portar- 
ci dietro un'infrastruttura pesantissima anche per 
le classi più semplici. Per questo i dataset hanno 
avuto scarsissimo successo tra i solution architect 
che oggi invece hanno da sempre preferito usare 
delle custom class e delle custom collection. 



ARCHITETTURA 
DI NHIBERNATE 

Senza entrare troppo nel dettaglio, vediamo qual è 
l'architettura di NHibernate, almeno quella che 
serve per questi primi esempi. Questo framework si 
contraddistingue dal fatto che l'utente ha pochissi- 
me interfacce con cui avere a che fare, poiché il suo 
intervento è di tipo non invasivo. Non abbiamo la 
necessità di far ereditare le nostre classi da una clas- 
se base persistibile o utilizzare complicate API. Dalla 
Figura 1 ci accorgiamo subito che NHibernate si 
colloca tra il layer applicativo e il database sotto- 
stante. La session è l'oggetto principale con cui inte- 
ragiamo. Prima doverosa precisazione: non dobbia- 
mo confondere la session di NHibernate con quella 
di ASRNET. Session per NHibernate ha lo stesso 
significato di Unii OfWork (pattern definito sempre 
da Martin Fowler). È un contenitore in memoria di 
oggetti recuperati dal database che tiene anche trac- 
cia delle modifiche ad essi apportate. Si occupa inol- 
tre della sincronizzazione di queste modifiche sul 
database sottostante. In pratica funge anche da 
cache rispetto al db. Nella vita di un'applicazione 
verranno istanziate e chiuse numerore session per 
lavorare sul database, un pò come faremmo per una 
connection. La creazione della session è gestita da 
una Session Factory, la cui creazione dipende dalla 
configurazione esterna che sarà fornita (tipo di ac- 
cesso al database, tipo di dialetto etc...). La Session 
Factory invece è unica per tutta la vita dell'applica- 
zione (si può pensare ad un singleton). Come fa 
NHibernate a sapere come leggere, inserire, e 
aggiornare gli oggetti? Semplice: la configurazione è 
gestita tramite file xml esterni, uno per ogni classe. 
Ogni file xml contiene le informazioni con cui map- 
pare i dati tra l'oggetto .net e la/le colonne delle ta- 
belle sul database. Di solito questi file hanno esten- 
sione *.hbm.xml. 



Applicazione 



trameni abjcct 




DrtÉÉhed abjctt 



Sesskn F*c tory 



Transartton 

Factory 



Connection 
Provider 




Session? 



Database 



Fig. 1: Lo schema logico di funzionamento di NHibernate 



CONFIGURIAMO 
UN PROGETTO 

Per Fuso di NHibernate in un qualsiasi progetto i 
passi da fare sono semplicissimi. 
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1. 



2. 



4. 



5. 



Scarichiamo la versione di NHibernate dal sito 
{www.nhibernate.org). Vanno bene anche solo i 
file binari. Allo stato attuale è presente la versio- 
ne 1.0.2. 

Creiamo un nuovo progetto di tipo console ap- 
plication. 

Nel solution explorer di Visual Studio, con un clic 
destro sul nome del nostro project, facciamo un 
Add Reference e referenziamo questi 4 file: NHi- 
bernate.dll, Castle.DynamicProxy.dll, Iesi.Collec- 
tion.dll, HashCodeProvider.dll (localizzateli nella 
directory dove avrete precedentemente installa- 
to NHibernate). 

Creiamo un file di configurazione per l'applica- 
zione facendo un Add Item e scegliendo Yitem 
Application Configuration. 
Copiamo all'interno del file di configurazione il 
seguente contenuto: 



<configSections> 



<section name="NHibernate" type= 
"System. Configuration. NameValueSectionHandler, 
System, Version = 1.0. 3300. 0,Culture=neutral, 
PublicKeyToken = b77a5c561934e089" /> 



</configSections> 



<NHibernate> 



<add key="hibemate. connection. provider" value= 

"NHibernate. Connection. DriverConnectionProvider" /> 
<add key="hibernate.dialect" value= 

"NHibernate. Dialect.MsSql2000Dialect" /> 
<add key="hibernate. connection. driver_class" value= 

"NHibernate. Driver.SqlClientDriver" /> 
<add key="hibernate. connection. connection_string" 
value="<<connection_string>>" /> 
</NHibernate> 

6. Creiamo poi una classe singleton, il cui compito 
è creare la session factory, ci servirà nel resto del 
nostro progetto: 

using NHibernate; 
using NHibernate. Cfg; 
namespace OrdiniManager 

i 

public class SessionHelper 

{ 

static ISessionFactory sessionFactory; 
static SessionHelper() 

{ 

Configuration cfg = new Configuration(); 
cfg.AddAssembly(Reflection.Assembly 

.GetExecutingAssemblyO); 
sessionFactory = cfg.BuildSessionFactory(); 

} 

public static ISession GetSession() 

{ return sessionFactory.OpenSessionQ;} 



Tutto qui. Nel file di configurazione abbiamo così 
introdotto una nuova section dove specifichiamo il 
tipo di provider di accesso ai dati, il dialetto usato 
secondo il tipo di database, e soprattutto la stringa 
di connessione al database. Per i nostri esempi uti- 
lizzeremo SQL Server 2000 (o MSDE). Per una con- 
sultazione sulle varie possibilità di configurazione 
potete consultare la documentazione online. 
Qualche nota sulla classe SessionHelper. Per creare la 
factory, l'unico lavoro da eseguire è istanziare un og- 
getto configuration ed effettuare un .AddAssemblyQ. 
Questa operazione comunica a NHibernate di cer- 
care nell'assembly specificato tutti i file *.hbm.xml 
di mappatura caricandoli in memoria. 



IL MOSTRO 
BUSINESS PROBLEMI: 
GESTIONE ORDINI 

Abbiamo configurato il nostro progetto. Adesso defi- 
niamo un problema di business da risolvere. Imma- 
giniamo di dover sviluppare un software per la ge- 
stione di Ordini per una società di fornitura hardwa- 
re. La Figura 2 mostra un diagramma statico delle 
classi che dovremmo implementare. 
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Fig. 2: Il diagramma statico delle classi 

In Figura 3 ecco la tabelle che serviranno alla persi- 
stenza di questi oggetti. Su SQL Server 2000 (o suc- 
cessivi) creeremo quindi una tabella di nome Ordini 
con i campi mostrati in Figura3. 



tbl_Ordine 

Importo 
data_ordine 

id_diente 








tbl_C Mente 




^ id_diente 
ragione_sociale 







Fig. 3: Le tabelle del DB che serviranno per 
la persistenza 

Partiamo dallo studio della classe Cliente: 

public class Cliente 
{ public int ID = 0; 
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public 


String RagioneSociale; 


public 


String Partitalva; 


public 


String Partitalva; 


} 



Per ragioni di spazio e visto che non vi è logica parti- 
colare per l'accesso ai campi, ometteremo nelle no- 
stre classi gli accessors getset (questo per rassicurare 
i puristi dell' incapsulation hiding!). 



MAPPIAMO 

LA CLASSE CLIENTE 

Come si diceva, la parte fondamentale per l'utilizzo 
di NHibernate è il file di mappatura. Creiamo quin- 
di un file xml nella nostra soluzione e popoliamolo 
con il seguente contenuto: 

<?xml version = "1.0" encoding = "utf-8" ?> 
<hibernate-mapping xmlns="urn: 

NHibernate-mapping-2.0" default-access="field"> 
<class name="Esempio. Cliente, Esempio" table= 

"tbl_Cliente"> 
<id name="Id" unsaved-value="0"> 
<generator class="native" /> 

</id> 

<property name="RagioneSociale" name= 

"Ragione_Sociale" /> 
<property na me =" Partitalva" name="Partita_Iva" /> 
<property name="Sede" /> 
</class> 
</hibernate-mapping> 

Per essere assistiti nell'editing dall'intellisense legge- 
te le informazioni nel Riquadro 1. Esaminiamo gli 
elementi più importanti. Ogni mappa ha un ele- 
mento <class> il cui attributo name è il nome (fully 
qualified) della classe .net, mentre l'attributo table è 
il nome della tabella corrispondente sul database. 
Per ogni campo della nostra classe esiste un ele- 
mento <property> corrispondente che porta il nome 
della colonna (attributo columrì). Nel caso di nomi 
uguali column può essere omesso. Attenzione all'e- 
lemento <id>. Come per le altre property definisce la 
corrispondenza tra il campo id della classe e la chia- 
ve univoca della tabella, ma definisce anche altri ele- 
menti. L'elemento <generator> definisce il compor- 
tamento di NHibernate per assegnare l'id all'oggetto 
.net. Native vuol dire che sarà sfruttato l'id prodotto 
dal database server secondo il modo nativo del dia- 
letto (il modo per recuperare l'id dell'ultimo record 
inserito cambia da dialetto a dialetto, ma per noi è 
totalmente trasparente). Importantissimo l'attribu- 
to unsaved-value che serve a far capire a NHiberna- 
te quando lanciare istruzioni di insert/update se- 
condo il valore assegnato. Vedremo meglio più tardi. 
Ovviamente per una consultazione più approfon- 



dita dei numerosissimi elementi possiamo riman- 
dare alla documentazione online (link). Il file .hbm 
.xml può essere conservato in qualsiasi posizione 
all'interno del progetto. L'importante è che sia 
impostato come risorsa embedded dell'assembly 
(cioè sia inglobato nella dll finale). Per fare ciò, nel 
solution explorer di Visual Studio, effettuate un click 
destro sul nome del file .hbm.xml e scegliete 
Property. Alla voce "Build Action" selezionate l'op- 
zione "Embedded Resource". Approfittiamo di que- 
sta occasione per dire che ogni qual volta saranno 
modificati esclusivamente i files .hbm (e nessuna 
riga di codice applicativo), la soluzione non sarà 
rigenerata automaticamente. Per vedere l'effetto 
delle modifiche assicuratevi di forzare una build 
manuale prima di provare le vostre modifiche. 



PERSISTENZA 

Abbiamo configurato il progetto e creato il mapping 
della classe Cliente. Proviamo adesso il funziona- 
mento di NHibernate nell'intero ciclo di vita di un 
oggetto. Consigliamo di controllare il flusso delle 
istruzioni SQL tramite il SQL Profiler come spiegato 
nel Riquadro 2. Proviamo a creare da codice un 
nuovo oggetto di tipo Cliente e a persisterlo sul data- 
base, il codice è davvero banale: 

ISession session = SessionHelper.GetSession(); 

Cliente cliente = new Cliente(); 

cliente. RagioneSociale = "RagioneSociale"; 

cliente. Partitalva = "0123456789012"; 

cliente. Sede = "Sede..."; 

session. SaveOrUpdate(cliente); // Viene eseguita la 

insert sul db. 
Console. Writel_ine("ID del cliente creato: " + cliente. ID); 
session. Flush(); 
session. Dispose(); 

Subito dopo l'istruzione new Cliente (), la pro- 
prietà cliente.Id ha ovviamente valore 0. In questo 
stato l'oggetto cliente è definito transient. Con il 
metodo .SaveOrUpdateO comunichiamo a 
NHibernate il comando di persistere sul database 
l'oggetto appena creato in memoria. A questo 
punto entra in gioco il valore unsaved-value sulla 
proprietà Id. Se la proprietà cliente.Id è uguale a 
unsaved-value, allora NHibernate capisce che 
l'oggetto è stato creato in memoria e non esiste 
ancora sul database. Sarà quindi scatenata un'i- 
struzione SQL di Insert per la persistenza. Ecco nel 
dettaglio cosa succede sul db: 

INSERT INTO tbl_Cliente ("..") VALUES (".."); 

SELECT Scope_Identity() 

Oltre alla insert, notiamo nello stesso round trip 
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una Select Scope_Identity() che ritorna ad 
NHibernate l'ultimo id inserito. NHibernate com- 
pleta anche il lavoro e assegna lìd all'ordine. 
L'oggetto Cliente si trova adesso nello stato defini- 
to persistent. Da questo momento in poi, qualsia- 
si altra modifica fatta in memoria sarà sincroniz- 
zata sul database, stavolta con istruzioni di 
Update. Completiamo le operazioni CRUD, pro- 
viamo a recuperare un oggetto ordine già esistente 
sul db e cancellarlo definitivamente: 

ISession session = SessionHelper.GetSession(); 
Cliente cliente = (Ordine)session.Get(typeof(Cliente), 1); 
cliente. RagioneSociale = "RagionaSociale modificata"; 
session. SaveOrUpdate(cliente); 
session. Flush(); 
session. Dispose(); 

Abbiamo usato session.GetO che recupera un 
oggetto dal database mediante chiave primaria 
che viene fornita nella firma del metodo. E' l'ope- 
razione più semplice, ovviamente non abbiamo 
avuto bisogno di specificare nomi di campi in que- 
sto caso. NHibernate sa come generare la giusta 
clausola where sul campo chiave primaria, poiché 
è tutto descritto nel file di mappatura. 
Ci manca la cancellazione: 

ISession session = SessionHelper.GetSession(); 
Cliente cliente = (Cliente)session.Get(typeof(Cliente), 1); 
session. Delete(cliente); 
session. Flush(); 
session. Dispose(); 

Come vedete l'unico oggetto di NHibernate con 
cui abbiamo avuto a che fare è sempre e solo ses- 
sion. 

Attenzione: NHibernate per migliorare le presta- 
zioni utilizza un metodo di scrittura tardivo chia- 
mato transparent write behind, in pratica le istru- 
zioni sql, saranno lanciate sul db solo saranno 
strettamente necessarie. 

Per esempio le insert saranno lanciate subito per 
fare in modo che l'id ritorni subito all'applicazio- 
ne, le update o le delete potranno essere postici- 
pate, in modo da ottimizzare i round trip sul db e 
combinare più istruzioni in una sola. Normalmen- 
te le istruzioni pendenti saranno lanciate alla 
chiusura della session mediante il metodo .flushO, 
(o automaticamente alle commit delle transazioni 
che non sono oggetto di questo articolo). 



comportano né più né meno in questo modo. Ma 
NHibernate è più di un generatore di codice. 
Proviamo ad aggiungere questi due attributi all'e- 
lemento class del file Ordine.hbm.xml, l'elemento 
class diventarà quindi: 

<class name="Esempio. Cliente, Esempio" table= 

"tbl_Cliente" dinamic-update="true" 
dinamic-insert="true"> 

In questo modo comunichiamo a NHibernate che 
quando saranno lanciate le sql di insert e update, 
saranno considerati solo i campi effettivamente 
modificati. Non dimenticate di eseguire la build 
manuale del progetto (abbiamo modificato solo 
file .hbm.xml). Rieseguendo il codice per l'inseri- 
mento e la modifica tramite profiler ci possiamo 
rendere conto che le INSERT e le UPDATE adesso 
hanno come parametri solo quelli effettivamente 
modificati. Questo garantisce meno traffico "inuti- 
le" sul database e soprattutto maggiore scalabilità 
dell'applicazione. 



ASSOCIAZIONI: 
MANY-TO-ONE 

Finora abbiamo visto un esempio semplicissimo 
che aveva una corrispondenza uno a uno con una 
tabella. Cominciamo a complicare (anche se di 
poco) il nostro modello. Modelliamo anche la clas- 
se Ordine. Ogni Ordine ha ovviamente un cliente 
che lo ha creato. Come cambia il nostro progetto? 
Ecco la classe Ordine: 



public class Ordine 


{ 


public 


int ID = 0; 






public 


Cliente Cliente = new 


ClienteO; // Reference 
ad un oggetto Cliente 


public 


String NoteOrdine; 






public 


doublé Importo; 






} 



Il Cliente è di tipo Cliente e non è rappresentato 
(come molti fanno!) con il suo id (chiave seconda- 
ria). Non dobbiamo preoccuparci di mettere id al 
posto delle reference fin quando stiamo sul nostro 
domain model. La trasformazione di reference in 
id al momento della persistenza è tutta demanda- 
ta ad NHibernate. Creiamo un file hbm.xml per la 
classe Ordine 



PERSISTENZA DINAMICA 

Ci sono tantissimi generatori di codice che pren- 
dono in pasto una tabella di un database e genera- 
no il codice c# per persistere record, e tali tool si 



<?xml version = "1.0" encoding = "utf-8" ?> 
<hibernate-mapping xmlns="urn: 

NHibernate-mapping-2.0" default-access="field"> 
<class name="Esempio. Ordine, Esempio" table= 

"tbl_Esempio"> 
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<id name="Id" unsaved-value="0"> 
<generator class="native" /> 

</id> 

<many-to-one name="Cliente" column = 

"IDCliente" outer-join = "true" /> 
<property name="DataOrdine" name= 

"DataOrdine" /> 
<property name="Importo" name= "Importo" /> 
</class> 
</hibernate-mapping> 



Notiamo come novità l'elemento <many-to-one>. 
Questo è il primo esempio di associazione. L'attri- 
buto outer-join verrà spiegato in seguito, per il 
resto la definiziona è molto simile all'elemento 
property. Ma nasconde una grande potenza. 
Proviamo a crearci dei dati su cui poter lavorare, 
creiamo prima un oggetto Cliente, poi un Ordine: 

ISession session = SessionHelper.GetSession(); 

Cliente cliente = new Cliente(); 

cliente. RagioneSociale = "RagioneSociale"; 

Ordine ordine = new Ordine(); 

ordine. Importo = 1000; 

ordine. Cliente = cliente; 

ordine. DataOrdine = DateTime.now; 

session. SaveOrUpdate(ordine); 

session. Flush(); 

session. DisposeQ; 



STRATEGIE DI FETCHIIUG 

Scegliere se caricare i dati o meno in una select 
con svariate join, oppure su select differenziate, è 
una vera e propria strategia che dal punto di vista 
di scalabilità deve essere affrontata in modo serio 
e misurato nelle vostre applicazioni. 
La potenza di NHibernate sta proprio nel fatto che 
mette a disposizione la possibilità di configurare 
questi metodi di recupero dei dati, addirittura 
senza toccare codice. 

Approfondiamo dunque l'elemento <many-to- 
one>: quest'ultimo ha un attributo outer-join i cui 
valori validi sono true, false o auto. 
Se outer-join vale true, allora NHibernate pro- 
durrà un'unica select con tante left outer join 
(secondo il dialetto SQL impostato) quanti saran- 
no gli elementi <many-to-one> definiti. Se outer- 
join è false, le istruzioni di select saranno distinte, 
ma è importante dire che saranno lanciate in 
maniera intelligente: ogni oggetto è caricato nella 
cache locale della nostra session, e qual'ora siano 
fatte richieste successive dello stesso oggetto, sarà 
utilizzato l'oggetto in cache (secondo il pattern 
Identity Map descritto da Martin Fowler). 
Avremo modo di approfondire in altre occasioni il 
fetching unitamente al lazy loading (caricamento 
tardivo) e alla cache poiché è poprio tramite que- 
sti particolari tuning che si ottengono prestazioni 
e vera scalabilità. 




Dal Profiler osserviamo che l'unica operazione 
.SaveOrUpdateO ha fatto scattare la persistenza sia 
per l'oggetto Cliente, che per l'oggetto Ordine, gli 
ID creati sul db sono stati catturati a regola d'arte 
e assegnati alle classi. Questa tecnica si chiama 
Persistence by reachability e assicura che la persi- 
stenza di un oggetto sarà estesa a tutti gli oggetti a 
lui collegati. 

Ma abbiamo appena iniziato a divertirci. 
Proviamo a fare la query di questo Ordine appena 
creato: 

Ordine ordine = (Ordine) session. Get(typeof(Ordine), 1); 

Dal profiler ci accorgiamo che la select è più com- 
plicata del solito: 

SELECT * from ...JOIN ... 

NHibernate ha creato una join tra le tabelle Ordine 
e Cliente, ha ottenuto un prodotto cartesiano, e 
mappato i campi sia sull'oggetto Ordine, che sul- 
l'oggetto Cliente. La corretta definizione della join 
è stata possibile sempre tramite i file hbm.xml. 
Niente più codice SQL sparso nelle nostre applica- 
zioni e query lunghe chilometri. Inoltre questo ha 
permesso in un unico round trip sul server di cari- 
care tutti i dati necessari. 



CONCLUSIONI 

Abbiamo visto ancora pochissimo di NHibernate, 
ma speriamo di essere riusciti a far capire l'estre- 
ma potenza e flessibilità di questo strumento. Il 
nostro cliente ha stravolto il database? Cambiamo 
gli hbm.xml e le classi e lavoreremo in pieno 
ambiente fortemente tipizzato. Non dovremo più 
toccare stringhe SQL e fare test, occuparci dei 
caratteri di escaping, o di come si recupera l'ulti- 
mo ID inserito in SQL Server o su Oracle, o ancora 
su DB2. Quando ci si rende conto di dominare un 
framework di questo tipo non si torna più indietro. 
Ma attenzione: la curva di apprendimento di 
NHibernate (a detta stessa dei creatori) è piuttosto 
ripida, quindi consigliamo caldamente un periodo 
di 2/3 settimane di studio /apprendimento perso- 
nale prima di poterlo utilizzare in progetti reali. 
Attenzione a metterlo in campo su progetti che 
hanno scadenze molto ravvicinate. Come contro- 
parte, dopo uno sforzo iniziale NHibernate vi 
garantirà un livello di produttività ineguagliabile, 
un supporto allo sviluppo enterprise completo ed 
efficiente, e un miglioramento della qualità del 
codice e perché no anche della vita di voi svilup- 
patori! 

Giancarlo Sudano 
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A TUTTA SCOMMESSA 

APPASSIONATI DI TOTOCALCIO? ECCO UN ALGORITMO POSSIBILE PER OTTENERE SISTEMI 
DECISAMENTE AFFIDABILI SENZA SPENDERE UNA FORTUNA. IMPAREREMO MOLTO 
SULLA STATISTICA E CREEREMO UN ESEMPIO PRATICO... 
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Gli appassionati di totocalcio o di altri gio- 
chi a pronostico, si trovano sempre alle pre- 
se con il problema di individuare il miglior 
pronostico da giocare. Spesso si parte dal budget 
previsto per la giocata e quindi si individua un buon 
sistema di riduzione; altre volte si fa ricorso ad al- 
goritmi di filtraggio condizionato. Ma in ogni caso, 
si ritorna al punto di partenza: il pronostico. 
A prescindere dalla metodologia di riduzione e da- 
gli eventi che sono presenti nella schedina, il pro- 
nostico in genere è composto da un numero ben 
preciso di doppie e triple, ed uno dei dubbi più fre- 
quenti è, una volta prefissata la composizione del 
sistema, individuare le partite sulle quali è più con- 
veniente giocare una doppia o una tripla. Spesso 
risulta più agevole definire un picchetto, indivi- 
duare cioè per ogni evento una probabilità di usci- 
ta per ciascun segno. Ma dopo? Come sfruttare al mas- 
simo questo picchetto? Sarebbe utile disporre di 
un algoritmo che, presi in pasto il nostro picchetto 
e la composizione del sistema in termini di doppie 
e triple, fornisca il pronostico che massimizza le 
probabilità di realizzare una vincita. Si consideri il 
seguente esempio in cui vi sono 4 partite e si desi- 
dera scommettere sul risultato finale "1 ", "X" o "2"po- 
tendo disporre di una doppia e di una tripla e note 
le probabilità di ciascun segno: 
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glabella /.- Eventi e picchetto utente (in %) A 



r l-1-1X-1X2 = 20% * 40% *(50% + 30%) * (30% + 35% + 35%) = 6,4% 


— > 


1-1-12-1X2 = 20% * 40% *(50% + 20%) * (30% + 35% + 35%) = 5,6% 




2-X-12-1X2 = 55% * 40% *(50% + 20%) * (30% + 35% + 35%) = 15,4% 




2-1X-1-1X2 = 55% * (40% + 40%) * 50% * (30% + 35% + 35%) = 22,0% 




1X2-X2-2-2 = (20% + 25% + 55%) * (40% + 20%) * 20% * 35% = 4,2% 





numero di possibili risultati, siano definite per ogni 
risultato le probabilità di realizzazione dello stesso, 
in modo tale che la somma delle probabilità dei ri- 
sultati di ciascun evento sia pari ad 1; determinare 
il pronostico che rende massima la probabilità di 
realizzazione ad esso associata. Questa generaliz- 
zazione consente all'algoritmo di essere utilizza- 
bile per diversi giochi a pronostico, come il totogol 
ed in genere può essere sfruttato come algoritmo 
decisionale per problemi di scelta opportunamente 
modellati. 



APPROCCIO 
AL PROBLEMA 

Per rispondere al problema, si potrebbe pensare di 
applicare una tecnica esaustiva, e cioè di generare 
tutti i possibili pronostici, calcolare la probabilità di 
realizzazione di ognuno e infine selezionare quello 
caratterizzato dalla probabilità maggiore. Tuttavia, il 
problema ha una naturale complessità esponenzia- 
le ed è necessario ottimizzare quanto possibile l'al- 
goritmo per poter pervenire alla soluzione ottima in 
tempi accettabili. Infatti, per calcolare il numero di 
combinazioni che si possono sviluppare, possiamo 
considerare per ogni segno (i.e.: "V\ "2X", "21X", ...) il 
numero di combinazioni delle occorrenze deside- 
rate rispetto ai segni disponibili; nel nostro caso, le 2 
fisse possono essere posizionate sui 4 eventi in 
c-4!/[2!*(4-2)!]-6modi differenti. Ad esempio: 
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Tabella 2: Possibili pronostici e relativa probabilità di uscita 



Le sei combinazioni possibili per disporre le due fìs- 
se sono 



Nell'esempio illustrato esistono ben 324 possibili P1-P2 

pronostici giocabili; ciò che interessa è individua- PI -P3 

re il pronostico che presenta la maggiore possibilità PI -P4 

di realizzazione. Più in generale il problema pò- P2-P3 

trebbe essere così definito: data una serie di even- P2-P4 

ti a pronostico, tali che per ciascuno vi sia lo stesso P3-P4 
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Inoltre, per ogni gruppo di segni, occorre consi- 
derare il numero di combinazioni possibili a cui i 
vari simboli (Le.: "1", "X", "2") presi senza ordine 
possono dar luogo per quel segno; nel caso delle 
2 fisse, esistendo 3 differenti simboli (l-X-2) e due 
posizioni, occorre considerare che le due fisse han- 
no un numero di segni possibili pari a s-32-9, ar- 
rivando così al risultato di 324 possibili pronosti- 
ci per il problema di esempio. 
Supposto che sia: 

s-segni 
C-combinazioni 

Supposto che il nostro sistema si componga di due 
fisse, una doppia e una tripla, avremo 



/ 


Segni 
possibili 


4 Eventi 


2 Eventi 


1 Eventi 


2 Fisse 


s=3 2 =9 

1 1 

1X 

1 2 

X1 

XX 

X2 

21 

2X 

22 


C=6*9=54 






1 Doppia 


s=3 
1-X 
1-2 
X-2 




c=2*3=6 




ITripla 


s=1 
(1X2) 






c=1*1=1 


Combinazioni totali 


54*6*1=324 





Spesso le ottimizzazioni nascono da semplici os- 
servazioni; una prima semplice osservazione è che 
non ha senso considerare tutti i possibili segni, ma 
che in ogni evento si può considerare un solo rap- 
presentante per ogni tipo di segno. Se prendiamo, 
come riferimento l'esempio iniziale, nell'evento 
Cesena- Juventus, non ha senso considerare ogni 
possibile fissa, ma ha senso considerare solo il se- 
gno "2"; infatti, a parità di tutti gli altri segni, il pro- 
nostico con il segno "2" avrà sicuramente proba- 
bilità maggiore dei pronostici con segno "1 "o "X"; 
lo stesso discorso è valido anche per la doppia, per 
cui sarà sufficiente considerare la sola doppia "2X". 
Da questa semplice osservazione, si ottiene che il 
peso dei segni possibili sarà sempre pari ad 1, con 
una notevole diminuizione di combinazioni da ge- 
nerare; nell'esempio, si passerà da 324 a solo 12 
combinazioni da verificare. Prima di procedere 
con una ulteriore osservazione, è importante sot- 
tolineare che l'algoritmo non lavora sul picchetto 
dell'utente, ma sul picchetto associato ai segni; 
inoltre, nella generazione dei segni si avrà cura di 
preservare l'ordine decrescente delle probabilità 



con la convenzione di considerare il "fattore cam- 
po", o più genericamente l'indice crescente del sim- 
bolo, a parità di probabilità; questo in pratica afferma 
che un eventuale segno "X2"h differente da "2X". 
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^Tabella 3: Eventi e picchetto utente (in %) j 
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gabella 4: Eventi e picchetto segni (in %) 



A questo punto risulta facile osservare che la pro- 
babilità dell'evento certo (tripla per il totocalcio, o equi- 
valente per altri modelli) è pari ad 1 per qualsivo- 
glia evento. Questo permette di disinteressarsi del- 
la posizione in cui ricadono gli eventi certi (considerato 
ultimo segno da allocare), con una interessante ri- 
caduta sul posizionamento del penultimo segno: 
essendo la probabilità, infatti, un prodotto di nu- 
meri positivi, sarà sufficiente selezionare gli n segni 
a probabilità maggiore tra quelli rimasti disponibi- 
li. Nell'esempio, se supponiamo di aver allocato le 
due fisse nei primi 2 eventi, sarà sufficiente sele- 
zionare il pronostico con la doppia in evento 3 sen- 
za testare quello con la doppia sull'evento 4, pas- 
sando così da 12 a 6 combinazioni da testare. Per 
capire maggiormente la qualità del risultato otte- 
nuto, si considerino 18 eventi con 4 possibili risul- 
tati combinabili ed una composizione del sistema 6F- 
4D-3T-5Q: la modalità selettiva utilizzata sul pe- 
nultimo segno permette di ridurre di un fattore 56:1 
il numero di iterazioni dell'algoritmo. 
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18 Eventi 


12 Eventi 


8 Eventi 


6F 


18.564 






4D 


3.060 


495 




3T 


816 


220 


56 


Combinazioni totali 


514.594.800 


^Combinazioni senza 3T 


9.189.180^ 



Il risultato ottenuto è già positivo, ma è ulterior- 
mente migliorabile, partendo da una semplice con- 
siderazione: si potrebbe tentare di allocare per pri- 
mi i segni che danno luogo a meno combinazio- 
ni, facendo "scivolare" alla fine i segni che incido- 
no maggiormente sul peso computazionale del- 
l'algoritmo e facendo crescere il peso computa- 
zionale del penultimo segno. Nell'esempio pro- 
posto, questo permetterebbe una ulteriore ridu- 
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zione di un fattore 8.25:1, che nel computo com- 
plessivo porta ad una riduzione di un fattore 462:1 
dell'intero algoritmo. 
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15 Eventi 


11 Eventi ^ 


6F 


18.564 


5.005 


462 


4D 
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1.365 




3T 


816 






Combinazioni totali 


514.594.800 


^Combinazioni senza 6F 


1.113.840^ 



La tabella delle possibili combinazioni tiene già 
conto del fatto che il peso di ogni segno sia pari ad 
uno; infatti, considerando i 4 simboli, si sarebbe 
dovuto tenere in conto che ci sarebbero state 4 pos- 
sibilità per la fissa, 6 per la doppia, 4 per la tripla 
ed una per la quadrupla con un numero totale di com- 
binazioni dell'ordine di IO 17 . 
Nell'esempio di apertura, l'utilizzo di tutte le os- 
servazioni prodotte porterebbe alla necessità di 
testare solo 4 combinazioni in luogo delle 324 pos- 
sibili, provando le varie posizioni della doppia e 
allocando successivamente le due fisse. 
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Tabella 5: Eventi e picchetto segni (in %) 



'comb. 


Posizione D 


Posizione F1 


Posizione F2 


Probabilità 


1 


1 


3 


2 


.80*.40*.50 = 16 f 0% 


2 


2 


1 


3 


.80*.55*.50 = 22,0% 


3 


3 


1 


2 


.80*.55*.40 = 17 f 6% 


4 


4 


1 


3 


.70*.55*.50 = 19 f 2% 


Combinazione ottima: 2 - 1X - 1 - 1X2 



LA CLASSE 

CMDSTACombinatiom 

L'algoritmo si basa sulla generazione esaustiva di 
combinazioni; sarà pertanto utile disporre di una 
classe che mette a disposizione delle primitive che 
consentano in modo agevole di generare ed itera- 
re delle combinazioni. 

La classe proposta si presta ad essere utilizzata se- 
cono lo schema classico di iterazione già presente 
in vari oggetti COM: 

CMDSTACombination combination = new 

CMDSTACombinationO; 
combination. Initialize(. ..); 
while (Icombination.EOF) 



combination. MoveNextQ; 



> 



Pertanto la classe disporrà di un metodo di inizia- 
lizzazione, delle proprietà per verificare lo stato 
dell'oggetto e il valore degli elementi della combi- 
nazione corrente, più altre proprietà quali appun- 
to YEOF. Disporrà inoltre dei metodi di avanza- 
mento e reset dell'oggetto, e più propriamente dei 
metodi MoveFirstQ e MoveNextQ. L'oggetto istanza 
della classe CMDSTACombination, una volta ini- 
zializzato sul numero di elementi da combinare e 
sulla lunghezza delle combinazioni da generare, 
in pratica genera le combinazioni utilizzando i va- 
lori da ad n-1, dove n è il numero di elementi. 
Questo consente alla classe di essere utilizzata in mo- 
do generico, come generatore di indici per qualsi- 
voglia insieme di oggetti da combinare o, come più 
avanti nell'algoritmo, anche per combinare un in- 
sieme non consecutivo o opportunamente ordi- 
nato di interi. L'oggetto mette a disposizione an- 
che una funzione statica che consente il calcolo 
delle combinazioni ottenibili, noto l'insieme de- 
gli elementi da combinare e la lunghezza della com- 
binazione; ricordando che il numero e di combi- 
nazioni di n numeri a gruppi di m è dato da c=n!/[m!(n- 
m)!], ovvero c=n*...*(n-m+l)/[2*...*m] e che e è un 
numero intero, l'algoritmo effettuale moltiplicazioni 
al numeratore, dividendo per i valori al denomi- 
natore appena possibile, al fine di ridurre i pro- 
blemi di overflow. 

public static long Combinations(int numbers, int length) 

i 

long tmp = 1; 
int d = 2; 

for (int i = numbers; i > numbers-length; i— ) 

{ 

tmp *= i; 



for(;(d <= length) && ((tmp%d) 



0);) 



tmp /= d+ + ; 



return tmp; 



> 



Per quanto riguarda la generazione delle combi- 
nazioni, essendo YEOF causato dalla MoveNextQ, 
questa avrà il compito di testare appena invocata 
se la combinazione corrente è l'ultima; il test av- 
viene in modo molto semplice sul primo elemen- 
to della combinazione: se questo è pari all'ultimo 
elemento assegnabile non esiste possibilità ulte- 
riore di iterazione su ciascun elemento. 
Nel caso invece di possibilità di passare alla suc- 
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cessiva combinazione, la procedura inizialmente 
trova a ritroso il primo elemento "iterarabile", e fa- 
cendolo aumentare di 1 alloca ai valori successivi 
tutti gli elementi restanti. 



if ((this.length ==0) || (combination[0] = = 

elements 


- length)) 


eof = true; 


if (EOF) 


return; 


int cur = length - 1; 


while ((cur >= 0) && (combination[cur] == elements 

- length + cur)) 


cur--; 


combination[cur] + + ; 


for (int j = cur + 1; j < length; j++) 


combination[j] = combination[cur] + j - 


cur; 



LA CLASSE 
CMDBETSymbol 

La classe CMDBETSymbol è una classe che mette 
a disposizione del programmatore un generico 
simbolo, ovvero un oggetto caratterizzato da un 
identificativo numerico, da un codice alfanume- 
rico che rappresenta una codifica del simbolo, da 
una descrizione e da un peso. La classe così concepita 
può essere utilizzata per rappresentare sia un sim- 
bolo della schedina che un segno, associando al 
peso la probabilità dello stesso. Ancora, la classe 
può rappresentare una qualunque grandezza e in- 
fatti verrà utilizzata anche nella gestione dell'or- 
dine dei segni da allocare, sfruttando il peso nella 
accezione di peso computazionale. Occorre pre- 
cisare che la gestione del peso è a carico delle pro- 
cedure e delle classi che istanziano oggetti della 
classe CMDBETSymbol; ad esempio, nel caso di 
probabilità, è importante che la somma delle pro- 
babilità dei simboli sia pari ad 1, ma il controllo è 
lasciato all'oggetto o procedura che fa uso della 
classe. La classe propone solo le proprietà neces- 
sarie alla sua gestione, quali la lettura dell'identi- 
ficativo e la lettura o scrittura di tutte le altre pro- 
prietà. 



DUE CLASSI PER LA 
GESTIONE DEGLI EVENTI 

L'algoritmo di selezione del pronostico lavora sul 
picchetto, definito come insieme delle probabilità 
associate ai possibili segni da giocare; tuttavia po- 
trebbe essere utile all'interno di una applicazione 
di gestione della schedina, disporre di una classe 
che consenta di gestire il picchetto utente, e cioè 
l'insieme degli eventi ed i simboli ad essi associati. 
La classe CMDBETEvent proposta utilizza un in- 



sieme di oggetti istanza della classe CMDBETSym- 
bol in cui il peso viene gestito come probabilità e si 
occupa, come detto in precedenza, di garantire la con- 
sistenza dei pesi. La classe, oltre alle immancabili fun- 
zioni di inizializzazione e di lettura e/o scrittura 
delle proprietà della classe, consente di definire il sim- 
bolo corrente (utilizzando la variabile interna sym- 
bollndex e l'omonima proprietà) su cui operano 
metodi e proprietà caratteristiche di un simbolo. 
Di particolare interesse è la funzione che si occupa 
di garantire la consistenza dei pesi-probabilità, ov- 
vero la funzione che garantisce che la somma dei va- 
ri pesi sia pari ad 1. Per garantire ciò, potrebbe es- 
sere necessario intervenire su alcune delle proba- 
bilità, modificandone il valore. Dovendo decidere 
quale simbolo modificare, si è considerata la modalità 
di inserimento dei dati; se ipotizziamo che tale mo- 
dalità segua il verso ordinario della scrittura (da si- 
nistra verso destra), allora possiamo ritenere "sa- 
crificabile" il simbolo immediatamente alla destra 
di quello cui si assegna un dato valore e via a se- 
guire, ovviamente considerando i simboli come se- 
quenza circolare. 

private void Adjust(int firstlndex) 

S 

int idx = firstlndex; 

int lastlndex = (firstIndex==symbol 

.GetUpperBound(O))? symbol. GetLowerBound(O) 

:firstlndex+l; 



doublé availableValue = 1; 



while (idx != lastlndex) 



{ 



if (symbol[idx].Weight > availableValue) 
symbol[idx].Weight = availableValue; 
availableValue -= symbol[idx].Weight; 



idx--; 



if (idx < symbol. GetLowerBound(O)) 
idx = symbol. GetUpperBound(O); 



> 



symbol[lastIndex].Weight = availableValue; 



} 



Questo metodo, privato, viene invocato dai meto- 
di della classe che effettuano variazioni sul peso 
dei simboli, subito dopo le eventuali variazioni; il 
parametro firstlndex consente di specificare l'indice 
del simbolo più importante, da lasciare invariato. 
Di seguito a titolo di esempio si riportano la proprietà 
Probability che permette di settare la probabilità 
del simbolo corrente, e il metodo SetProbability, 
che consente di settare la probabilità di un sim- 
bolo senza modificare il simbolo corrente specifi- 
cando l'indice del simbolo da aggiornare. 

public void SetProbability(int symbollndex, doublé vai) 

S 

symbol[symbolIndex].Weight = val>l?l:val; 
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Adjust(symbollndex); 



> 



public doublé Probability 



{ 



get { return symbol[symbolIndex].Weight; } 
set { symbol[symbolIndex].Weight = 

value>l?l:value; Adjust(symbollndex); } 



> 



La classe CMDBETEvent è a sua volta utilizzata dal- 
la classe CMDBETEventSheet che ha la funzione di 
"collettore" di eventi. Questa classe si presta quin- 
di ad essere utilizzata come struttura dati per con- 
tenere le informazioni degli eventi in input. Si evi- 
terà tuttavia un maggior approfondimento su que- 
sta classe, essendo la stessa di potenziale interes- 
se per una eventuale applicazione ma di scarso ri- 
lievo per l'algoritmo trattato. 



LE CLASSI PER 
LA GESTIONE 
DEL PICCHETTO 

Come detto in varie occasioni, ai fini dell'algoritmo 
il picchetto è l'insieme delle probabilità associate 
non ai simboli ma ai segni. La classe CMDBETPi- 
quet è strutturata in modo tale da raccogliere le 
informazioni relative al picchetto di un singolo 
evento, così come inteso ai fini dell'algoritmo. 
La struttura della classe è piuttosto simile a quel- 
la proposta per la classe CMDBETEvent, fatta ec- 
cezione per la gestione delle modalità di valoriz- 
zazione delle probabilità dei segni. Infatti, non oc- 
corre più garantire che la somma delle probabilità 
sia pari ad uno, ma sarà sufficiente un controllo 
che il valore immesso non sia superiore a questo li- 
mite. Sulla generazione del picchetto per ogni even- 
to è importante rispettare quanto detto sulla com- 
posizione dei segni, considerando la combinazio- 
ne dei segni maggiormente probabili e preservan- 
do al loro interno l'ordinamento dei simboli ri- 
spetto alle probabilità e, in caso di pari probabi- 
lità, al "fattore campo". Analogamente a quanto vi- 
sto per le classi di gestione degli eventi, viene de- 
finita una classe CMDBETPiquetSheet che di fatto 
rappresenta la struttura dati contenente il picchettò 
dell'intero modello. La classe CMDBETPiquetSheet, 
inoltre, offrirà le funzioni e le proprietà che con- 
sentiranno di pervenire al pronostico ottimo. 



inilZIALIZZAZIOME 
DELLE ISTANZE 

Prima di procedere con l'illustrazione delle parti 
più salienti dell'algoritmo, può essere utile pro- 
porre alcune porzioni di codice che utilizzano le 



classi fin qui presentate e che potranno essere in- 
serite, ad esempio, nella form principale dell'ap- 
plicazione. Per semplicità, saltate le parti di rac- 
colta dei dati in input e di presentazione degli stes- 
si in output, al fine di fornire un insieme di istruzioni 
che consentano l'esecuzione ed il test dell'appli- 
cazione, verranno illustrate una funzione per il 
riempimento casuale del "picchetto utente", la fun- 
zione di inizializzazione del picchetto vero e pro- 
prio e la funzione di calcolo della soluzione. Per 
comodità, l'applicazione farà uso delle seguenti 
variabili: 



private CMDBETEventSheet EventSheet; 


public 


int N_ 


_0_ 


_EVENTS = 14; 


public 


int N_ 


_0_ 


_SYMBOLS = 3; 


public 


int N_ 


_0_ 


_MARKS = 3; 



L'oggetto EventSheet, è dunque la struttura prepo- 
sta a rappresentare lo spazio dati utente, e può es- 
sere inizializzata utilizzando i valori casuali resti- 
tuiti da una istanza della classe System. Random; 
una semplice funzione può prevedere il settaggio 
dei primi n-1 simboli con valori compresi tra lo e 
l'inverso del numero di simboli; l'ultimo simbolo 
così sarà in automatico settato dalla classe CMD- 
BETEvent in modo tale da rispettare la somma ad 
1 del picchetto utente. In modo euristico, possia- 
mo prevedere un fattore correttivo di 0.4 rapportato 
al numero di simboli da sommare al valore casua- 
le, per rimediare all'inevitabile sbilanciamento che 
altrimenti si avrebbe nei confronti dell'ultimo sim- 
bolo. 

private void EventSheetRandomGenerate() 



{ 



System. Random oracle = new System. Random(); 



for(int i = 0; i < N_0_EVENTS; i + + ) 
for (int j = 0; j < N_0_SYMBOLS - 1; j++) 
EventSheet. SetProbability(i, j, System. Math.Round( 
oracle. NextDouble() / N_0_SYMBOLS + 
■ 4/ N_0_SYMBOLS, 3)); 



EventSheetRefresh(); //output dati utente 
} 

È utile a questo punto disporre di una funzione 
che inizializzi il picchetto, così come inteso dal- 
l' algortitmo, a partire dal picchetto utente. Questa 
funzione dovrà per ogni evento definire l'ordine 
dei simboli e comporre i segni che andranno a de- 
finire il picchetto rappresentato da una istanza del- 
la classe CMDBETPiquetSheet passata per riferi- 
mento: 

private bool Piquetlnitialize(ref CMDBETPiquetSheet 

piquetSheet) 
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String mark; 



doublé probability; 



int[] symbolOrder; 



symbolOrder = new int[N_0_SYMBOLS]; 



int k; 



for (int i = 0; i < N_0_EVENTS; i ++) 



{ 



piquetSheet.SetPiquetData( 

i, String. Format("Piquet n° {0:#}", i + 1)); 
for (int j = 0; j < N_0_SYMBOLS; j + + ) 



{ 



for (k = j; (k > 0) && 

EventSheet.GetProbability(i, j) > 
EventSheet.GetProbability( 
i, symbolOrder[k-l]); k— ) 
symbolOrder[k] = symbolOrder[k-l]; 



symbolOrder[k] = j; 



> 



for (int j = 0; j < N_0_MARKS; j ++) 



{ 



mark = ""; probability = 0; 



for (k = 0; k <= j; k++) 



{ 



mark += EventSheet.GetCode( 

i, symbolOrder[k]); 
probability += EventSheet.GetProbability( 

i, symbolOrder[k]); 



> 



piquetSheet.SetMarkData(i, j, mark, 

String. Format("Mark n° {0:#}", j + 1)); 
piquetSheet.SetProbability(i, j, probability); 



pronostico che si vuole calcolare; la procedura in- 
fine, termina correttamente se il numero totale di 
segni richiesto coincide con il numero di eventi in 
gioco. Un ulteriore controllo potrebbe essere ag- 
giunto per garantire che il picchetto soddisfi il vin- 
colo che la probabilità associata all'ultimo segno sia 
uguale ad 1. Per concludere, è utile presentare la 
procedura che invoca il calcolo del picchetto otti- 
mo; per comodità supponiamo che il risultato sia 
inserito in un oggetto di tipo ListView IvResult im- 
postato con modalità di visualizzazione List. 

private void GetOptimalCard() 

i 

CMDBETPiquetSheet PiquetSheet = new 

CMDBETPiquetSheetQ; 

PiquetSneet.Initialize(N_0_EVENTS, N_0_MARKS); 



if (Piquetlnitialize(ref PiquetSheet)) 

i 

PiquetSheet. OptimalCardRefreshQ; 



IvResult. Items.ClearQ; 



System.Windows.Forms.ListViewItem Ivi; 
for(int i=0; i < N_0_EVENTS; i ++) 
Ivi = IvResult. Items.Add( 

PiquetSheet. GetOptimalMark(i)); 
Ivi = IvResult. Items.Add( 

String. Format("{0:##0. #######}%", 
PiquetSheet. OptimalProbability * 100)); 



else 



IvResult. Items.Clear(); 

IvResult. Items.Add("Verificare parametri"); 




> 



k = 0; 



int marksNumber = 0; 



for (int i = 0; i < N_0_MARKS; i + + ) 



{ 



PiquetSheet. SetMarkOccurrence( 

i, System.Int32.Parse(...)); 
marksNumber + = 

PiquetSheet. GetMarkOccurrence(i); 



return marksNumber == N_0_EVENTS; 



} 



Risulta chiaro che per ogni evento la funzione pri- 
ma definisce l'ordine dei simboli sulla base delle 
probabilità degli stessi, e poi definisce il segno, 
componendo i simboli secondo l'ordine ottenuto. 
Dopo aver composto tutti i segni e calcolato per 
ciascuno di essi la probabilità, la procedura definisce 
la struttura in termini di occorrenza dei segni nel 



OptimalCardRefresh 

La classe CMDBETPiquetSheet, come detto in pre- 
cedenza, consente non solo la definizione del pic- 
chetto secondo i criteri dell'algoritmo, ma anche di 
calcolare il pronostico ottimo in termini di proba- 
bilità. 

Il calcolo avviene in due fasi; inizialmente avvie- 
ne la preparazione delle strutture dati sulla base 
dei parametri dell'istanza, quindi viene invocata 
la procedura che effettua la scansione dei possibi- 
li pronostici alla ricerca di quello ottimo. La pro- 
cedura di scansione dei pronostici, com'era facile 
aspettarsi, è una procedura ricorsiva. 
Il metodo Initialize viene invocato per inizializza- 
re le variabili private della classe CMDBETPiquet- 
Sheet: 

private CMDBETPiquet[] Piquet; 
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private int piquetlndex = 0; 



private int marklndex = 0; 



private int marksNumber = 0; 



private int[] markOccurrence; 



private CMDBETSymbol[] markOrder; 



private int[] optimalCard; 



private doublé optimalProbability; 



private int[] currOptimalCard; 



private doublé currOptimalProbability; 

public void Initialize(int piquetsNumber, int 

marksNumber) 



{ 



int i; 



Piquet = new CMDBETPiquet[piquetsNumber]; 
for (i = Piquet. GetLowerBound(O); i < = 

Piquet. GetUpperBound(O); i++) 



Piquet[i] = new CMDBETPiquet(i+i, "" , 

marksNumber); 
Piquetlndex = 0; Marklndex = 0; 

markOccurrence = new int[marksNumber]; 
optimalCard = new int[piquetsNumber]; 
this. marksNumber = marksNumber; 
} 



La procedura OptimalCardRefreshO prepara i da- 
ti prima della invocazione della procedura ricor- 
siva OptimalCardRetrieve •(...), che richiede in in- 
put l'indice del segno da allocare e la lista degli 
eventi disponibili per l'allocazione. 
In particolare, la procedura definisce l'ordine di 
allocazione dei segni, utilizzando come peso il nu- 
mero di combinazioni possibili in accordo alla 
composizione del sistema. Per comodità, verrà uti- 
lizzato come peso il numero di combinazioni ottenibili 
sulla totalità degli eventi senza procedere come 
nell'esempio iniziale calcolando il numero esatto 
delle combinazioni ottenibile man mano che vie- 
ne determinato il segno da allocare; questa scelta 
di comodo di fatto non altera le considerazioni fat- 
te in precedenza, in quanto non verrà mai utiliz- 
zato il numero di combinazioni, ma soltanto l'or- 
dinamento in base al peso computazionale. 

public void OptimalCardRefreshO 

J 

int eventsNumber = Piquet. GetUpperBound(O) 

- Piquet. GetLowerBound(O) + 1; 

markOrder = new CMDBETSymbol[marksNumber]; 
CMDBETSymbol tmpMark; 
long combs; 



for (int i=0; i < marksNumber - 1; i++) 

_i 

combs = CMDSTACombination.Combinations( 

eventsNumber, markOccurrence[i]); 
int k = i; 
markOrder[k] = new CMDBETSymbol(i, "", "", 

combs); 
while ((k > 0) && (markOrder[k].Weight 

< markOrder[k-l].Weight)) 

{ 

tmpMark = markOrder[k]; 
markOrder[k] = markOrder[k-l]; 
markOrder[k-l] = tmpMark; 

k-; 

} 

_} 

markOrder[marksNumber - 1] = new 

CMDBETSymbol(marksNumber - 1, "", "", -1); 



optimalProbability = 0; 

currOptimalCard = new int[eventsNumber]; 

currOptimalProbability = 1; 

int[] availableList = new int[eventsNumber]; 

for (int i = 0; i < eventsNumber; i++) 

availablel_ist[i] = i; 
OptimalCardRetrieve(0, ref availableList); 



OptimalCardRetrieve 

La funzione OptimalCardRetrieve è il nucleo cen- 
trale dell'intero algoritmo; è una procedura ricor- 
siva che ha il compito di iterare tutte le possibili 
combinazioni per i primi n-2 segni, per poi proce- 
dere come descritto inizialmente nella allocazione 
degli ultimi 2 segni. La procedura pertanto pre- 
senta al suo interno due blocchi di istruzioni, uno 
per la clausola di uscita dalla ricorsione, e l'altro 
per la generica iterazione che corrisponde alla ri- 
cerca esaustiva sulT i-esimo segno. 
La clausola di uscita, come detto, si presenta quan- 
do il segno da allocare è il penultimo segno; lo sche- 
letro della funzione pertanto sarà il seguente: 

private void OptimalCardRetrieve(int marksCursor, ref 

int[] availableList) 

{ 

doublé startingOptimalProbability = 

currOptimalProbability; 
int availablesNumber = 

availableList. GetUpperBound(O) - 
availableList. GetLowerBound(O) + 1; 
if (marksCursor == marksNumber - 2) 

{ 

... // allocazione ultimi 2 segni 

} 

else 
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// allocazione i-esimo segno 



<= optimalCard.GetllpperBound(O); i++) 
optimalCard[i] = currOptimalCard[i]; 



// costruzione availableNextList 



OptimalCardRetrieve(marksCursor + 1, ref 

availableNextList); 



> 



} 



L'allocazione degli ultimi 2 segni, come detto, pre- 
vede l'ordinamento decrescente per probabilità 
degli eventi disponibili: di questi, i primi /everran- 
no associati al penultimo segno, e i restanti all'ul- 
timo segno (/e è il numero di occorrenze richieste 
per il penultimo segno). Ovviamente, si parla di i- 
esimo segno con riferimento all'ordine dei segni 
ottenuto sul peso computazionale. Dopo aver ef- 
fettuato l'allocazione, e contestualmente aver ag- 
giornato la probabilità del pronostico corrente, il ri- 
sultato ottenuto viene confrontato con l'ottimo at- 
tuale e se migliore viene memorizzato come otti- 
mo corrente. 

int[] bestOthers = new int[availablesNumber]; 

int k = 0; 

for (int i=0; i < availablesNumber; i ++) 

J 

k = i; 

while ((k > 0) && (Piquet[availablel_ist[i]] 
.GetProbability(markOrder[marksNumber-2 ].Id) > 
Piquet[bestOthers[k-l]].GetProbability( 
markOrder[marksl\lumber-2].Id))) 

{ 

bestOthers[k] = bestOthers[k-l]; 

k-; 

} 

bestOthers[k] = availablel_ist[i]; 

} 



for (int i=0; i < markOccurrence[ 

markOrder[marksl\lumber-2].Id]; i++) 

_{ 

currOptimalCard[bestOthers[i]] = markOrder[ 

marksl\lumber-2].Id; 
currOptimalProbability *= Piquet[bestOthers[i]] 
.GetProbability(markOrder[marksNumber-2].Id); 
_} 

for (int i=0; i < markOccurrence[markOrder[ 

marksNumber-l].Id]; i++) 
currOptimalCard[bestOthers[markOccurrence[ 

markOrder[marksNumber-2].Id] + i]] = 
marksNumber-1; 

if (currOptimalProbability > optimalProbability) 

J 

optimalProbability = currOptimalProbability; 
for (int i = optimalCard.GetLowerBound(O); i 



} 



La parte ricorsiva della procedura invece istanzia 
un oggetto combination della classe CMDSTA- 
Combination per l'iterazione delle combinazioni; 
in caso di proprietà EOF dell'oggetto combination 
[Le.: se il numero di occorrenze per il segno cor- 
rente fosse pari a zero) pari a TRUE, la procedura pro- 
cede alla ricorsione sul segno successivo, conse- 
gnando come lista di valori ammissibili la lista cor- 
rente: 

CMDSTACombination combination = 

new CMDSTACombination(); 
int occurrence = markOccurrence[ 

markOrder[marksCursor].Id]; 
combination. Initialize(availablesNumber, occurrence); 
if (combination. EOF) 
OptimalCardRetrieve(marksCursor + 1, 

ref availableList); 
else 

i 

while (Icombination.EOF) 

{ 

... // allocazione segni e chiamata ricorsiva 
combination. MoveNextQ; 



} 



La parte di allocazione dei segni e di preparazio- 
ne e chiamata ricorsiva riparte dal valore corrente 
di probabilità del pronostico memorizzata ad ingresso 
funzione e iterando sui numeri presenti nella lista 
degli eventi disponibili, ne verifica l'appartenenza 
o meno alla combinazione corrente: se il numero 
appartiene alla combinazione, nel pronostico cor- 
rente viene memorizzato il segno selezionato per 
l'evento e l'evento non viene incluso nella lista da 
passare alla chiamata successiva, altrimenti l'e- 
vento entra nella prossima lista di eventi disponi- 
bili e il valore del pronostico per l'evento viene po- 
sto a -1 (utile più che altro in fase di debug, ma non 
necessario per il corretto funzionamento dell'al- 
goritmo). Una volta completatala scansione sugli 
eventi disponibili è possibile effettuare la chiama- 
ta ricorsiva. 

currOptimalProbability = startingOptimalProbability; 
int[] availableNextList = new int[availablesNumber 

- occurrence]; 
int k = 0, j =0; 

for (int i = 0; i < availablesNumber; i++) 
if ((k < combination. Length) && 

(combination. Index(k) == i)) 

i 

currOptimalCard[availableList[i]] = 
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markOrder[marksCursor].Id; 



currOptimalProbability *= Piquet[availablel_ist[i]] 
.GetProbability(markOrder[marksCursor].Id); 



k+ + ; 



else 



currOptimalCard[availablel_ist[i]] = -1; 
availableNextList[j] = availablel_ist[i]; 



> 



OptimalCardRetrieve(marksCursor + 1, 

ref availableNextList); 

Una ulteriore ottimizzazione può essere effettua- 
ta introducendo una tecnica di cut nella genera- 
zione delle combinazioni; infatti, poiché la pro- 
babilità del pronostico corrente è un valore che 
dovrà essere moltiplicato per le probabilità dei 
prossimi segni individuati, ed essendo tutti que- 
sti numeri inferiori all'unità, non ha senso prose- 
guire con la generazione del pronostico corrente 
quando la sua probabilità non può essere miglio- 
re del valore dell'ottimo attuale. Il taglio potrebbe 
risultare tanto più efficace quanto prima si rag- 
giunge un valore alto di ottimo attuale; a tal pro- 
posito potrebbe essere introdotta l'euristica di or- 
dinare la lista degli eventi disponibili per probabi- 
lità decrescente. Ovviamente la tecnica di cut in- 
troduce dei costi computazionali (ordinamento 
delle liste di eventi, operazioni di confronto) e non 
sempre sortisce i risultati voluti; tuttavia gli even- 
tuali effetti positivi di una tecnica di cut in genere 
permettono una notevole riduzione delle itera- 
zioni per algoritmi di questo tipo e il loro utilizzo può 
essere lasciato alla scelta del programmatore o an- 
cora a valutazioni euristiche fatte dallo stesso al- 
goritmo. Per completezza, si riportano le porzio- 
ni di codice che implementano l'euristica, ed in 
particolare, la generazione della lista nella Opti- 
malCardRefreshO, la generazione della avaliable- 
NextList nel ramo ricorsivo della OtpimalCardRe- 
trieveQ e l'allocazione degli ultimi due segni nella 
clausola di uscita della stessa procedura, che non 
richiede più la parte di ordinamento essendo la li- 
sta già ordinata. 

for (int i = 0; i < eventsNumber; i++) 

i 

int k = i; 

while ((k > 0) && (Piquet[i].GetProbability( 

markOrder[0].Id) > Piquet[availablel_ist[ 
k-l]].GetProbability(markOrder[0].Id))) 

{ 

availablel_ist[k] = availablel_ist[k-l]; 

k-; 

} 

availablel_ist[k] = i; 



} 


//availableNextl_ist[j] = 


= availablel_ist[i]; 


int w = j; 



while ((w > 0) && (Piquet[availablel_ist[i]] 

.GetProbability(markOrder[marksCursor+l].Id) 

> Piquet[availableNextList[w-l]].GetProbability( 

markOrder[marksCursor+l].Id))) 

{ 

availablel\lextl_ist[w] = availablel\lextl_ist[w-l]; 
w— ; 



> 



availablel\lextl_ist[w] = availablel_ist[i]; 



j++; 



for (int i=0; i < markOccurrence[ 

markOrder[marksl\lumber-2].Id]; i++) 



{ 



currOptimalCard[availablel_ist[i]] = markOrder[ 

marksNumber-2].Id; 
currOptimalProbability *= Piquet[availablel_ist[i]] 
.GetProbability(markOrder[marksNumber-2].Id); 



> 



for (int i=0; i < markOccurrence[markOrder[ 

marksNumber-l].Id]; i++) 
currOptimalCard[availableList[markOccurrence[ 

markOrder[marksl\lumber-2].Id] + i]] = 
marksNumber-1; 

In particolare, non occorre variare i controlli sulla 
combinazione corrente, in quando questa viene 
fatta sfruttando la natura di indice degli elementi 
dell'oggetto combination. 



ESEMPIO 

Con riferimento alla istanza presa in esame in oc- 
casione delle considerazioni sulla complessità, cioè 
al modello composto da 18 eventi con la compo- 



/ — 


A 


B 


C 


D ^ 


1 


140 


190 


195 


475 


2 


205 


200 


70 


525 


3 


250 


355 


95 


300 


4 


505 


110 


55 


330 


5 


175 


520 


180 


125 


6 


145 


535 


150 


170 


7 


270 


185 


400 


145 


8 


465 


405 


80 


50 


9 


445 


115 


120 


320 


10 


135 


210 


395 


260 


11 


285 


65 


295 


355 


12 


490 


75 


275 


160 


13 


290 


220 


225 


265 


14 


310 


315 


215 


160 


15 


75 


530 


385 


10 


16 


335 


90 


100 


475 


17 


235 


240 


365 


160 




265 


80 


355 


300 A 
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sizione 6F-4D-3T-5Q per il risultato finale, consi- 
deriamo il picchetto utente proposto (riferito a 
1000): A questo corrisponderà il picchetto, inteso 
ai fini dell'algoritmo, seguente: 






D 


DC 


DCB 


DCBA ^ 


475 


670 


860 


1.000 


2 


D 


DA 


DAB 


DABC 


525 


730 


930 


1.000 


3 


B 


BD 


BDA 


BDAC 


355 


655 


905 


1.000 


4 


A 


AD 


ADB 


ADBC 


505 


835 


945 


1.000 


5 


B 


BC 


BCA 


BCAD 


520 


700 


875 


1.000 


6 


B 


BD 


BDC 


BDCA 


535 


705 


855 


1.000 
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In rosso sono riportati i segni in corrispondenza 
dei quali si ottiene l'ottimo, mentre in azzurro ci 
sono i riportati i valori più alti per ogni segno. Il 
valore di ottimo presenta lo 0,66% di probabilità di 
realizzazione; questo risultato, contrariamente al- 
le apparenze, non è un risultato negativo: si pensi 
che la probabilità di fare un ambo secco su una 
ruota è pari allo 0,25%!!! Ovviamente, la probabilità 
di fare risultato è fortemente vincolata alla qualità 
del picchetto. Nella particolare istanza proposta, 
la tecnica di cut non ha sortito alcun effetto, in 
quanto il valore minimo di probabilità per il taglio 
sul ramo riscorsivo si è fermato allo 0,86% e non 
si è ritenuto opportuno agire sulla allocazione de- 
gli ultimi due segni, in quanto operazione lineare. 
Tuttavia occorre notare che gli ultimi due segni 
rappresentavano ben 1 1 eventi su un totale di 18 (qua- 
si 2/3) e questo è sufficiente a spiegare il mancato 
taglio da parte dell'euristica. È però importante 
osservare che nella classe dei problemi a com- 
plessità esponenziale, è in genere opportuno ap- 



portare ogni possibile miglioramento si intraveda. 
Nell'esempio proposto, su una macchina Pentium 
D 3GHz, 1 GB RAM, l'algoritmo ha fornito la solu- 
zione in circa 4 secondi; la generazione esaustiva 
avrebbe richiesto, quindi, approssimativamente 
30 minuti; infine sarebbe stato inutilizzabile l'al- 
goritmo che avesse generato tutte le combinazio- 
ni su tutti i possibili segni. 



CONCLUSIONI 

L'algoritmo ora è pronto per essere testato e uti- 
lizzato; tuttavia è necessario fare alcune precisa- 
zioni, in particolare sulla reale possibilità di au- 
mentare le probabilità di vincita. Da un punto di 
vista matematico l'algoritmo in effetti permette di 
ottenere il pronostico che ha maggiori possibilità 
di riuscita, ma questo a condizione che il picchet- 
to dell'utente costituisca un valido modello della 
realtà. Se utilizzassimo ad esempio le quote dei 
bookmaker per ottenere il picchetto, sicuramen- 
te escluderemmo la possibilità di considerare nel 
pronostico finale le cosiddette "sorprese". Infatti, 
sempre in riferimento ad una ipotetica applica- 
zione per il totocalcio, se immaginiamo che la pri- 
ma in classifica incontri l'ultima in classifica, si- 
curamente il picchetto sarebbe molto a favore del- 
la prima in classifica e se alla vittoria di questa è 
associata una probabilità alta difficilmente il pro- 
nostico conterrà un segno diverso dalla fissa; tut- 
tavia, uno scommettitore particolarmente abile o 
fortunato, potrebbe intravedere in questa partita la 
possibilità di una sorpresa e decidere di associare 
all'evento un picchetto che dia maggiori possibilità 
al pareggio o, perché no, alla sconfitta della prima 
in classifica. In questo caso, l'ingresso della "sor- 
presa" nel pronostico sarebbe resa possibile dal 
picchetto e vincolata esclusivamente dai picchet- 
ti delle altre partite. Ovviamente le limitazioni di 
uso nell'ambito dei giochi a pronostico dipendo- 
no solo dalla fantasia del giocatore; si potrebbe 
pensare, ad esempio, di utilizzare l'algoritmo per de- 
cidere la giocata da effettuare in un gruppo di scom- 
mettitori. Ogni componente del gruppo potrebbe 
indicare un proprio picchetto (o un pronostico da 
convertire in picchetto); facendo girare l'algorit- 
mo sul picchetto ottenuto come media di tutti i 
picchetti, l'applicazione potrebbe decidere il pro- 
nostico più indicato sulla base delle considerazio- 
ni di tutti i componenti del gruppo di scommes- 
sa. Da notare, infine, che l'algoritmo si presta no- 
tevolmente ai giochi a pronostico, ma è a tutti gli ef- 
fetti un algoritmo decisionale esatto, e pertanto è 
applicabile a qualunque problema decisionale mo- 
dellabile secondo lo schema generale del proble- 
ma ad esso associato. 

Carmelo Durante 
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Le librerie OpenSoun 



Oracle 10g Express Edition 

PER LA PRIMA VOLTA IN VERSIONE GRATUITA, ARRIVA IL DB PER LE AZIENDE 



Oracle si è sempre caratteriz- 
zata per la sua volontà di 
servire il mercato B2B, ed è anco- 
ra così. Per anni il suo database è 
stato il leader nel segmento 
aziendale, ed ancora oggi detie- 
ne un'enorme fetta di questo 
mercato. Fino a ieri nessuna o 
quasi nessuna applicazione desti- 
nata alle aziende medio piccole 
ha potuto usufruire della poten- 
za di questo DB soprattutto in 
relazione agli enormi costi da 
sostenere. Oggi tutto è cambiato 
e Oracle per la prima volta pre- 
senta una versione Express 
Gratuita del proprio strumento 
principe. Si tratta di una novità 
non da poco. Questa versione è 
identica in tutto e per tutto alla 
versione standard eccetto che 



per il fatto di poter servire un 
solo processore, gestire fino a un 
massimo di 4GB di dati, e utiliz- 
zare un solo GB di RAM. I lin- 
guaggi con cui può essere inte- 
grato tramite appositi connector 
sono i più svariati: Java, C, PHP, 
la piattaforma .NET. Si tratta di 
una vera e propria rivoluzione a 
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tutto vantaggio degli sviluppato- 
ri che possono in questo modo 
affiancare ai tradizionali 
Microsoft SQL server, MySQL, 
PostgreSQL un nuovo strumento 
la cui affidabilità è proverbiale. 
Di fatto la versione Express di 
Oracle 10G può essere liberamen- 
te usata in tutta una serie di con- 
testi, redistribuito con le proprie 
applicazioni e installato sui ser- 
ver in modo multiutente. 
Sicuramente una novità eccezio- 
nale da prendere con entusia- 
smo. Vi invitiamo a provare 
subito questo eccezionale stru- 
mento, e apprenderne ulteriori 
caratteristiche leggendo il bel- 
l'articolo di Fabrizio Fortino in 
questo stesso numero di 
ioProgrammo 



AXIS 1.3 

IL FRAMEWORK PER LO SVILUPPO 
DI WEB SERVICE IN JAVA 

Che i Web Service rappresentino una 
risorsa enorme per la programmazio- 
ne è ormai noto, in questo stesso 
numero di ioProgrammo diamo 
enorme spazio all'argomento pro- 
prio con una serie di esempi pratici 
per lo sviluppo. Mancano dai nostri 
esempi proprio quelli relativi a Java 
di cui ci occuperemo nei numeri suc- 
cessivi della rivista. Axis è comunque 
il tool fondamentale per poter svilup- 
pare WS con il linguaggio di SUN. Il 
suo utilizzo è abbastanza semplice, e 
supporta tutte le caratteristiche 
avanzate come ad esempio la genera- 



zione dinamica dei WSDL oppure il 
debugging delle trasmissioni SOAP. 
Uno strumento indispensabile di cui 
non mancheremo di parlare ulterior- 
mente 
Directory: /Axis 

BEANSHELL 2-OB4 

PER DOTARE LE TUE 
APPLICAZIONI JAVA DI UN 
LINGUAGGIO DI SCRIPTING 

Ce ne parla approfonditamente Fe- 
derico Paparoni nel bell'articolo pre- 
sente in questo stesso numero di 
ioProgrammo. Beanshell è un lin- 
guaggio di scripting e al contempo 
un engine embedded per le tue appli- 
cazioni Java. Sostanzialmente si può 



inserire V engine all'interno dell'ap- 
plicazione e consentire agli utenti di 
utilizzare il linguaggio per estendere 
il software con moduli. In pratica una 
sorta di linguaggio Macro applicabile 
direttamente al software sviluppato 
da te. Molto interessante e utile in 
tutti quei casi in cui si vuole offrire 
una profonda personalizzazione 
senza dover ogni volta ricompilare il 
codice 
Directory:/ BeanShell 

DEV CPP 4.9.9.2 

UN EDITOR C++ A BASSO COSTO 

Dev C++ è un editor distribuito su 
licenza GPL, come tale non ha costi 
relativi al diritto d'autore. Come tutto 
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o quasi tutto il software GPL la sua 
economicità non è affatto sinonimo 
di scarsa qualità. Al contrartio Dev 
C++ è uno degli editori più amati ed 
utilizzati da chi sviluppa in C++. 
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Le caratteristiche sono notevoli. Si va 
dal Debugger integrato, al project 
Manager, al Class Browser, al Code 
Completion. L'insieme di queste 
caratteristiche, oltre una leggerezza 
innata dell'ambiente lo rende parti- 
colarmente comodo da utilizzare per 
sviluppare progetti C++ anche di 
grandi dimensioni 
Directory:/ Dev CPP 

ECLIPSE 3.1.2 

L'IDE DI PROGRAMMAZIONE 
UNIVERSALE 

Eclipse è diventato in breve tempo 
uno dei prodotti più usati dai pro- 
grammatori di tutto il mondo. Si trat- 
ta ovviamente di un ambiente di pro- 
grammazione. La prima caratteristi- 
ca da mettere in evidenza è che l'in- 
tero eclipse è scritto in Java e questo 
lo rende disponibile con funzionalità 
omogenee sia su Linux che su Win- 
dows. 




La seconda caratteristica è relativa 
alla sua architettura a plugin. Se da 
un lato l'ambiente si presenta di de- 
fault come destinato alla program- 
mazione Java, con semplici plugin 
diventa un IDE per PHP, per C++ o 
per praticamente qualunque altro 
linguaggio disponibile. Inoltre sem- 
pre grazie alla sua architettura a plu- 



gin, è possibile aggiungere funziona- 
lità aggiuntive che lo rendono ad 
esempio un ambiente RAD e Visual 
nel caso si installi il plugin Visual 
Eclipse. 
Directory: /DevCPP 

J2SE 1.5.0.6 

IL FRAMEWORK ESSENZIALE PER 
PROGRAMMARE IN JAVA 

Se siete dei programmatori java non 
potete prescindere dall' installare il 
JDK, si tratta del framework di base 
che contiene il compilatore, le utility 
e le librerie per potere iniziare a lavo- 
rare con Java. Quello che vi presen- 
tiamo è il secondo aggiornamento 
della versione 1.5 rilasciato da brevis- 
simo tempo e contenente alcune 
migliorie dal punto di vista della se- 
curity e moltissimi Bug Fix che mi- 
gliorano in linea generale l'usabilità e 
l'affidabilità del linguaggio 
Directory:/ J2SE 

JAVA LAUNCHER 2.0 

LANCIARE APPLICAZIONI JAVA 
CON UN DOPPIO CLIC 

Un tool di rara semplicità che con- 
sente di distribuire applicazioni Java, 
garantendo all'utente la massima 



semplicità nell'avvio. Java Launcher 
comprime tutte le classi e le risorse 
relative ad un'applicazione in un 
unico file .EXE che potrà essere lan- 
ciato come una comune applicazione 
Windows. Gratuito. 
Directory:/ javalauncher 

NUSOAP 0.6.3 

LA LIBRERIA PER SVILUPPARE WEB 
SERVICES CON PHP 

Ne abbiamo parlato abbondantemen- 
te negli esempi legati allo sviluppo di 
WS con Php in questo stesso numero 
di ioProgrammo. Si tratta di una libre- 
ria di veramente pochi Kb di dimensio- 
ne, ma straordinariamente completa. 
Consente la generazione automatica 
del WSDL, il debugging della trasmis- 
sione dei messaggi SOAP ed esporta 
metodi e interfacce abbastanza sem- 
plici da rendere la programmazione 
dei WS estremamente rapida. Viene 
ancora oggi preferita all'estensione 
"ufficiale" presente in PHP5 perché 
nonostante sia ancora leggermente più 
lenta di essa tuttavia offre alcune carat- 
teristiche che la nuova versione non 
offre, come ad esempio proprio la 
generazione automatica del WSDL 
Directory:/ Nusoap 



VS.PHP For 
Visual Studio 2005 

L'ADDIN PER USARE VISUAL STUDIO COME EDITOR PER PHP 



Si tratta di una vera e 
propria novità. 
Utilizzare uno degli edi- 
tor più evoluti al mondo 
per programmare per il 
web utilizzando il lin- 
guaggio PHP. Alcuni 
potrebbero pensare che 
si tratti in fondo del 
solito editor con sintassi 
colorata, e invece tutte le 
funzioni avanzata ci sono tutte, 
dalla syntax highlighting alla 
code complexion, più alcune fun 
zionalità decisamente avanzate 
che non si trovano tipicamente 
nemmeno in editor nativi per 




PHP come ad esem- 
pio il supporto a 
smarty il template 
designer di PHP uti- 
lissimo per separare 
la logica di pro- 
grammazione da 
quella di design. Si 
tratta insomma di 
uno strumento di 
eccezionale rilevanza che può 
diventare realmente significati- 
vo per coloro che fino ad ora 
non hanno trovato un IDE suffi- 
cientemente evoluto per lo svi- 
luppo delle proprie Web 
Application. 
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MYSQL 5.0 

LO SCHELETRO DI INTERNET 

Così tanti sono i progetti su internet 
che fanno capo a MySQL che si può 
tranquillamente dire che MySQL è 
una delle strutture portanti del Web. 
Nato come DB ultraleggero per servi- 
re progetti di piccole dimensioni si è 
evoluto nel tempo fino a diventare 
uno dei database con il maggior 
numero di funzionalità esposte. 




Si va dalla ricerca full text al supporto 
alle transazioni senza per questo 
dimenticare la leggerezza del sistema. 
MySQL è estremamente semplice da 
usare e al contempo estremamente 
potente e questo ne fa uno dei server 
di database più usati al mondo. 
Qualcuno ancora lo taccia di non 
essere sufficientemente professionale 
da reggere il confronto con i DB com- 
merciali più costosi, noi non siamo 
fra questi. MySQL è del tutto parago- 
nabile a server di DB del costo di sva- 
riate migliaia di euro e in molti casi 
prevale in prestazioni e affidabilità. 
Directory: /Mysql 

NHIBERNATE 1.0.2 

IL TOOL DI PERSISTENZA DEI DATI 
PER ECCELLENZA 

Ce ne parla Giancarlo Sudano in questo 
stesso numero di ioProgrammo. 
Nhibernate è il porting del famoso 
Hibernate per Java su piattaforma .NET. 




infatti di trasformare le normali 
Query SQL in oggetti e classi di modo 
che siano omogenei con il codice a 
cui uno sviluppatore è abituato. Oltre 
a questo Nhibernate è un tool di per- 
sistenza che consente di "salvare" lo 
stato dei dati su uno Storage, anche 
questo in modo indipendente dal lin- 
guaggio SQL. A fare da ponte fra l'ar- 
chitettura del database e il linguaggio 
ad oggetti sarà un semplice file XML. 
Directory:/Nhibernate 

PYTHON 2.4.2 

IL LINGUAGGIO EMERGENTE 

Di Python ci siamo occupati a più 
riprese su ioProgrammo nel corso del 
tempo e torneremo nuovamente a 
farlo. Si tratta di un linguaggio real- 
mente interessante che offre agli svi- 
luppatori una serie di caratteristiche 
innovative che lo rendono piuttosto 
flessibile. Intanto si tratta di un lin- 
guaggio ad oggetti fra quelli che inter- 
pretano la programmazione ad oggetti 
nella maniera più standard possibile. 
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La sua utilità è estrema, consente 



Si tratta poi di un linguaggio interpre- 
tato, modulare e multipiattaforma. 
Può essere esteso con librerie esterne, 
può funzionare su Windows e su Linux 
senza modifiche di rilievo eccetto nel 
caso in cui il software debba interagire 
in modo stretto con il sistema. Proprio 
per quanto riguarda linux di fatto 
Python viene utilizzato dalla maggior 
parte delle distribuzioni come base 
per la costruzione dei propri tool per 
la gestione del sistema. In ambiente 
Windows si sta rapidamente affer- 
mando anche per la costruzione di 
applicazioni dotate di interfacce grafi- 
che e questo testimonia la flessibilità 
del linguaggio 
Directory:/ Python 

PHP 5.1.2 

IL LINGUAGGIO PRINCIPE 
PER IL WEB 

PHP è decisamente sempre più il lin- 
guaggio che consente di sviluppare 



applicazioni Web in modo rapido ed 
efficiente. La release che vi presentia- 
mo in questo numero è la 5.1.2 che 
corregge alcuni bug di sicurezza rela- 
tivi alla precedente. La forza di PHP 
risiede nella curva di apprendimento 
sostanzialmente nulla, nella comple- 
tezza del linguaggio, nella capacità di 
essere da un lato un linguaggio pro- 
cedurale atipico in quanto probabil- 
mente l'unico sopravvissuto fra i lin- 
guaggi procedurali, ma anche un 
grande linguaggio ad oggetti, per 
quanto ed ancora più stranamente la 
migrazione alla programmazione ad 
oggetti che in altri settori è stata 
quasi istantanea per quanto riguarda 
PHP rimane ancora abbastanza mar- 
ginale 
Directory:/ PHP512 

SPRIHIG 
FRAMEWORK 1.2.7 

IL FRAMEWORK DEI FRAMEWORK 

Spring è decisamente un argomento 
caldo. Lo abbiamo definito come "il 
framework dei framework" perché 
riunisce sotto un unico cappello una 
serie di tecnologie già esistenti, utiliz- 
zandole però nel migliore dei modi e 
fornendo allo sviluppatore un'inter- 
faccia omogenea. Si tratta di un argo- 
mento caldo perché in moltissimi 
stanno adottando questo strumento 
per lo sviluppo delle proprie applica- 
zioni, per l'alta flessibilità nell'utiliz- 
zo di oggetti di business e per la sua 
completezza. Sicuramente ne parle- 
remo ancora su ioProgrammo 
Directory:/ Spring 

LAVADORA LO 

UN PLUGIN PER SVILUPPARE WEB 
SERVICES CON ECLIPSE 

Il progetto Lavadora nasce con lo 
scopo di creare un plugin per lo svi- 
luppo di Web Services su piattaforma 
Eclipse. Al momento fornisce diversi 
wizard per lo sviluppo dei ws, gene- 
razione automatica del WSDL, brow- 
sing degli UDDI e deployment facili- 
tato su Tomcat. Un progetto impor- 
tante dunque per gli sviluppatori 
Java che desiderano pubblicare sul 
Web i loro servizi nell'ambito della 
creazione di applicazioni geografica- 
mente distribuite. 
Directory:/ Lavadora 
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ORDINAMENTI 
PER DISTRIBUZIONE 

SI TRATTA DI METODI DALLE SORPRENDENTI PERFORMANCE CHE PERÒ RICHIEDONO 
UN'ATTENTA ANALISI DEI DATI SOTTOPOSTI A ORDINAMENTO. CERCHIAMO DI CAPIRE 
COME FUNZIONANO E A COSA BISOGNA STARE ATTENTI 
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Un'importante categoria di metodi di ordina- 
mento è detta distribution sort, ossia ordi- 
namento per distribuzione. Questa famiglia 
di algoritmi ribalta la logica sottesa ai più conosciuti 
metodi di sorting, come bubble sort o quick sort, per 
i quali è ripetuto "continuamente" il confronto tra 
elementi della lista da ordinare, che produce even- 
tualmente scambi. Qui non sono previsti confronti, si 
tratta semplicemente di collocare (distribuire) ap- 
propriatamente i dati in aree di memoria; magari ite- 
rando il processo in più fasi. Sono stati introdotti mol- 
to tempo addietro, negli anni sessanta, nello stesso 
periodo che hanno visto la luce i più conosciuti me- 
todi di ordinamento, nel tempio mondiale della scien- 
za: il MIT. Attualmente gli algoritmi di ordinamento per 
distribuzione stanno trovando sempre più applica- 
zioni per le loro formidabili prestazioni. In passato 
erano stati riposti nel cassetto pervia della loro "con- 
siderevole" richiesta di risorse. Oggi con le memorie 
RAM che aumentano di giorno in giorno la loro ca- 
pacità e velocità questo ostacolo è superato. 



RADIX SORT 
CON ESEMPIO 

Radix sort è un veloce e stabile algoritmo di ordina- 
mento che ordina un insieme di voci identificate in 
modo univoco da chiavi. Ogni chiave può essere 
una stringa o un numero. Il metodo è anche cono- 
sciuto come postai sort. L'algoritmo opera con 
complessità 0(n*k) con n il numero di elementi e k 
la lunghezza media delle chiavi. Radix sort funzio- 
ne come segue: 



L'ORDINAMENTO DEL POSTUMO 



È di fatto l'algoritmo usato negli 
uffici postali per l'ordinamento di 
pacchi e lettere. Si procede 
ordinando in sequenza lo stato, la 
provincia, la citta, la zona, la strada 
e il numero. Ha complessità 0(k*n) 
come molti altri della famiglia, e 



solo in determinate condizioni (se k 
molto minore di n). Si differenzia 
dal radix sort perché procede 
secondo una metodologia top 
down (dal più grande al più 
piccolo). Viceversa radix sort è 
sviluppato in modalità buttom up. 



• Considera la parte meno significativa (una sin- 
gola cifra, un singolo o un gruppo di bit o un ca- 
rattere) di ogni chiave; 

• Ordina la lista degli elementi così selezionati, 
mantenendo l'ordine pregresso nel caso di 
parti meno significative identiche (ciò garanti- 
sce la caratteristica di stabilità dell'algoritmo); 

• Ripete l'ordinamento per tutte le altre parti più 
significative delle chiavi. 

Si ottiene complessità O(n) per un numero di voci 
molto più grande della grandezza della chiave. Se 
ad esempio la chiave usata è uno short integer l'in- 
tero processo di ordinamento si esaurisce in due 
soli passaggi. Il problema che non sempre ci trovia- 
mo in questa situazione. Nel caso sfavorevole oltre 
ad una degenerazione del metodo bisogna fare i 
conti con un "eccessivo" uso della memoria. 
Esistono dei metodi ad istogramma che si applica- 
no in questi casi e riducono tale spreco. Facciamo 
un esempio concreto. Supponiamo di voler ordina- 
re la seguente sequenza di numeri: 

150, 7, 25, 30, 12, 305, 46, 59 

Dopo la prima iterazione si ordinano le cifre meno 
significative e si ottiene: 

150, 30, 12, 25, 305, 46, 7, 59 

Si nota come 150 è sempre prima di 30, così come 
25 è riportato prima di 305, proprio perché si man- 
tiene l'ordine che avevano nella lista in preceden- 
za. Dopo la seconda fase si distribuiscono i numeri 
in base alla seconda cifra significativa. 
Ovviamente, si assume che numeri con una sola 
cifra siano interpretati con lo zero davanti. Quindi 
7 è come se fosse 007 (da non confondere con Fa- 
gente segreto!). 

305, 7, 12, 25, 30, 46, 150, 59 

Infine, dopo la terza fase sorprendentemente la 
lista si ritrova ordinata: 
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7, 12, 25, 30, 46, 59, 150, 305 



SOLUZIONE RICORSIVA 

La soluzione naturale è ricorsiva, ma questa può 
essere anche implementata con Fuso di strutture 
supplementari in modo iterativo. Visioniamo la so- 
luzione ricorsiva. Supponiamo di applicare l' algorit- 
mo a numeri, facilmente si può posporre al caso di 
stringhe. Per passi l'algoritmo funziona così: 

1 Prendiamo la cifra significativa di ogni 
chiave; 

2 Ordiniamo la lista di elementi basata su 
quella cifra raggruppando elementi con la 
stessa cifra nello stesso secchio; 

3 Ricorsivamente ordiniamo ogni secchio, 
partendo con la cifra immediatamente 
successiva in termini di significatività; 
M Concateniamo i secchi. 



Nell'implementare la soluzione proposta si possono 
usare liste a puntatori che si prestano in modo natu- 
rale alla strutturazione dei secchi. Ogni bucket è un 
nodo che conterrà tutti gli elementi ad esso riferito 
ossia una lista ad essa appesa. Tale elaborazione ri- 
schia di innescare frammentazione della memoria 
che per grandi quantità di dati potrebbe degradare 
le performance dell'algoritmo. Una alternativa è 
usare degli array, strutture quindi che sono stabili in 
memoria perché allocate in fase di dichiarazione. In 
tal caso sicuramente si hanno computazioni più ve- 
loci che si pagano però con un maggiore spreco di 
memoria. Ad ogni modo se la tipologia dei dati lo 
consente è preferibile usare la seconda struttura 
proposta. Facciamo un esempio. Vogliamo ordinare 
la stessa sequenza precedentemente proposta. 

150, 7, 25, 30, 12, 305, 46, 59. 

Collochiamo nei primi secchi gli elementi con cifra 
più significativa. Delle centinaia: 

zero: 7, 25, 30, 12, 46; uno: 150; tre : 350. 

Distribuiamo adesso rispetto alla seconda cifra. È 
necessario farlo per il solo secchio zero delle centi- 
naia: zero: 7; uno: 12; due: 25; tre: 30; quattro: 46; 
cinque: 59. Infine, bisogna ordinare per la cifra me- 
no significativa. Non è necessario poiché non vi so- 
no bucket che contengono più di un elemento. Con- 
cateniamo i risultati partendo dal bucket zero della 
cifra meno significativa computata. Si ottiene così 
l'elenco numerico ordinato: 

7, 12, 25, 30, 46, 59, 150, 305 



Questo versione è efficiente quando la maggior par- 
te delle righe necessita di essere ordinata con poche 
cifre significative di profondità. In tal caso solo po- 
che cifre poco significative necessitano di essere ela- 
borate. Se la tipologia dei dati invece richiede ripe- 
tute esplorazioni in profondità è preferibile la ver- 
sione non ricorsiva di radix sort. Partendo dalle cifre 
più significative, al contrario di come è stato descrit- 
to l'algoritmo in principio, effettivamente le prime 
cifre ad essere distribuite sono le meno significative. 
Ciò è dovuto al modo con cui viene sviluppata la 
ricorsione. 



RADIX SORT 
NON RICORSIVO 

Funziona come descritto al principio e fa uso di 
alcune duplicazioni delle strutture dati dove sono 
inizialmente contenuti i dati per consentire il trava- 
so dei numeri che man mano vengono ordinati, nel- 
le varie fasi della distribuzione da una strutture al- 
l'altra. Di seguito è riportato il codice che imple- 
menta radix sort. Si presuppone di passare come pa- 
rametro una lista vettore dati di numeri long (interi 
lunghi) che contiene i numeri da ordinare. Si inseri- 
scono inizialmente cento numeri casuali, attraversi 
la procedura numerijoasuali. La routine intermedia 
radix_sort è richiamata dalla radix_sort_ric. Per in- 
tenderci poiché si vogliono ordinare numeri interi 
(long) di quattro byte saranno necessarie quattro 
fasi (primo parametro di radix_sort), infatti la fun- 
zione è richiamata quattro volte. È necessario usare 
il comando » di shift di un byte e il relativo cast 
esplicito. Con memset si inizializza il blocco (vettore 
cont) a zero. 

void radix_sort (int byte, long N, long *s, long *d) 

{ int i; 

long cont[256]; 

long indice[256]; 

// inizializza il vettore contatore a 0; 

memset (cont, 0, sizeof (cont)); 

// shift di un byte e conversione esplicita che 

// permette l'analisi di cifredi significatività 

// incrementale 

for ( i=0; i<N; i++ ) cont[((s[i])>> 

(byte*8))&0xff] + + ; 

indice[0]=0; 

for (ì=l; i<256; i++) indice[i]=indice[i-l]+cont[i-l]; 

for ( i=0; i<N; i++ ) d[indice[((s[i])>> 

(byte*8))&0xff] ++] = s[i];> 

void radix_sort_ric (long *s, long *temp, long N) 
{ radix_sort (0, N, s, temp); 
radix_sort (1, N, temp, s); 
radix_sort (2, N, s, temp); 
radix_sort (3, N, temp, s); } 
void numeri_random (long *dati, long N) 




APPLICAZIONI 
PER PROCESSORI 
PARALLELI 

La versione ricorsiva 
del radix sort ha 
importanti applicazioni 
nell'ambito del calcolo 
parallelo. Ogni 
suddivisione può 
essere elaborata 
indipendentemente 
dal resto. Così ogni 
ricorsione viene 
passata al primo 
processore disponibile. 
Un primo processore 
potrebbe essere usato 
per avviare l'algoritmo 
quindi elaborare la 
cifra più significativa. 
Un secondo, un terzo e 
così via sarebbero 
innescati nell'uso per 
le cifre 

immediatamente dopo 
significative. 
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for ( int i=0; i<N; i++ ) dati[i]=rand()|(rand()<<16); 



ALBERO 

I metodi di visita 

permettono di 

accedere a tutti gli 

elementi dell'albero, 

quelli maggiormente 

usati sono tre: 



Anticipato 

Nell'ordine vengono 
visitati: 

• la radice, 

• il sottoalbero 

sinistro, 
• il sottoalberodestro. 

Simmetrico 

Nell'ordine vengono 
visitati: 

• il sottoalbero 

sinistro, 

• la radice, 

• il sottoalbero destro. 

Posticipato 

Nell'ordine vengono 
visitati: 

• il sottoalbero 

sinistro, 

• il sottoalbero destro, 

• la radice. 



> 



long dati[100]; 



long temp[100]; 



int main (void) 



{ int i; 



numeri_random(dati, 100); 



radix_sort_ric (dati, temp, 100); 



for ( i=0; i<100; i++ ) cout << dati[i] << '\n'; 



getchQ; 



> 



BUCKET SORT 

Inizialmente gli elementi sono distribuiti in alcune 
aree, che chiameremo anche secchi o bucket. Queste 
aree sono disposte in modo che siano ordinate 
rispetto alle chiavi. Ogni bucket se necessario viene 
ordinato e i contenuti sono concatenati. Studiamo 
Bit sort che in letteratura si trova sia come sinonimo 
di bucket sort sia variante dello stesso. Qui si estre- 
mizza il concetto poiché ogni secchio contiene un 
solo elemento, o al più copie delle stesso elemento 
ripetuto nella lista da ordinare. Si assume che le 
chiavi delle voci che si desidera ordinare siano con- 
tenute in un "circoscritto" range. Verrà chiarito dal- 
l'esempio il significato dell'accezione circoscritto 
nell'ambito del nostro contesto. Inoltre, ci deve esse- 
re una sola voce per ogni chiave. Il secondo esempio 
ci mostrerà come sia facilmente superabile questo 
vincolo. L'algoritmo si sviluppa su tre fasi. La prima 
configura un elenco di binari in un insieme pari alla 
cardinalità delle chiavi. A tale scopo verrà usato un 
array di variabili booleane inizializzate a falso. La 
seconda fase esamina ogni voce e usa il valore della 
chiave per settare a vero l' array prima descritto. 
Ogni dato che si incontra setterà a vero il corrispon- 
dente indice del vettore di booleani. L'idea sta quin- 
di nel far corrispondere un valore ad un indice. La 
terza prevede che si scandisca il vettore dei binari al 
fine di comporre il vettore di dati ordinato. 
Esaminiamo subito la complessità perché certa- 
mente provoca uno shock. Il bin sort è 0(n), esatta- 
mente lineare. Il prezzo da pagare però è che vi siano 
delle pre- condizioni alquanto restrittive. Se n è la 
dimensione del vettore da ordinare, o se preferite il 
numero di elementi da trattare, e con m indichere- 
mo il massimo valore che può assumere una chiave. 
È facile intuire che la fase due necessita di n passag- 
gi mentre la tre di m. Quindi si ha 0(n+m). Ora, se ci 
troviamo in una tipologia di dati per la quale m o è 
più piccolo di n, oppure è comunque comparabile, 
allora si ottiene il risultato ad effetto O(n) già enfati- 
camente annunciato. Purtroppo se i dati sono distri- 
buiti su un campo di variazione molto ampio, per 
cui la chiave massima assume un valore molto gran- 



de ci troviamo nella situazione per la quale m è 
molto maggiore di n. In tal caso la complessità passa 
a O(m). Facciamo una semplice stima. Se ad esem- 
pio desideriamo ordinare 10 A 4 (n) numeri interi a 32 
bit, e questi si distribuiscono in tutto il range defini- 
to dall'insieme, allora m è pari a 2 A 32. Così oltre che 
una gran quantità di memoria anche l'algoritmo 
degenera. In questo caso sono preferibili algoritmi 
come heap sort o quick sort. Ricordo che per questi 
la complessità è circa 0(nlog(n)). Facendo i conti 
risulta circa nlog(n) 2 A 17 che è molto minore di 
2 A 32. Ecco l'implementazione, nel caso di ordina- 
mento per un insieme di interi. Si può notare come 
siano sviluppate in modo naturale le tre fasi dell'al- 
goritmo, e come adesso risultino ancora più chiare. 
Le costanti MMAX e NMAX contengono rispettiva- 
mente il valore massimo della chiave (in altri termi- 
ni non possono essere trattati numeri più grandi di 
MMAX) e il massimo numero di elementi da or- 
dinare. I vettori d contiene i dati, mentre b è di sup- 
porto e contiene i valori booleani. Infine, n è il reale 
numero di elementi da ordinare, ovviamente deve 
essere minore o uguale di NMAX. 

Il Costanti e variabili globali 
const int MMAX=500; 
const int NMAX=100; 
int n; 



int d[NMAX]; 



bool b[MMAX]; 



// BIN sort 



void bin_sort (int *dati, bool *bin) 



{ int i,j; 



// inizializzazione del vettore bin (1°) 
for (i=0; i<MMAX; i + + ) bin[i]=false; 
// Costruzione del vettore bin (2°) 
for (i=0; i<n; i++) bin[dati[i]]=true; 
// Ricomposizione del vettore dati (3°) 

j=Q; 

for (i=0; i<MMAX; i + + ) 

if (bin[i]) dati[j++] = i; 

Y, 

int main() 

{ input_dati(d); 

bin_sort(d,b); 

output_dati(d); 
} 

Per ragioni di spazio non vengono riportate le im- 
plementazioni delle routine standard di input e 
output, che troverete comunque sul CD. Il limite di 
tale algoritmo oltre che nella tipologia dei dati che 
devono sottostare ad un determinato range, sta 
nel fatto che non si possono avere ripetizioni di 
chiavi. Questo secondo inconveniente si può facil- 
mente superare considerando anziché un vettore 
di booleani uno di interi. Inizializzato a zero. Così 
ogni qual volta si incontra un numero, che nel vet- 
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tore citato rappresenta l'indice, si incrementa il 
valore corrispondente. Alla fine il valore contenu- 
to nelle singole celle del nuovo array modificato 
indicherà quante volte si ripete quella determina- 
ta voce. Si tratta di Bucket sort. Le modifiche da 
apportare rispetto al caso precedente sono poche. 
In fase di dichiarazione specificare che b è un vet- 
tore di interi: 

const int MMAX=5Q0; 

const int NMAX=100; 

int n; 

int d[NMAX],b[MMAX]; 

è la procedura di ordinamento dovrà essere modi- 
ficata come segue. 



// BUCKET sort 


void bucket. 


_sort (int 


*dati, int *bin) 


{ 


int i,j,z; 








// inizializzazione 


del vettore bin (1°) 




for (i=0; 


i<MMAX, 


i++) bin[i]=0; 




// Costruì 


zione del vettore bin (2°) 




for (i=0; 


i<n; i++ 


) bin[dati[i]]++; 




// Ricomposizione 


del vettore dati (3°) 


j=0; 




for 0=0; 


i<MMAX, 


i++) 




for (z=0; 


z<bin[i] 


, z++) dati[j++] = i; 


}; 



come si può notare si apportano modifiche a tutte 
le fasi. La prima inizializza con zero anziché con 
false. La seconda incrementa la cella indicata dal 
valore del dato anziché portarla a true. È questo 
l'espediente che permette di considerare i dupli- 
cati di una generica chiave. Infine l'ultima, sempli- 
cemente con un secondo ciclo si aggiorna il nume- 
ro di duplicati valori nel vettore dati. Non è stato 
previsto alcun confronto in conformità alla logica 
degli ordinamenti per distribuzione. Se non vi è al- 
cun valore nella generica casella di bin, il ciclo di 
for non effettua alcun ciclo, non producendo alcu- 
na assegnazione. 



ALBERI INCREMENTALI 

Un altro approccio per comprendere il metodo è 
tracciare le soluzioni attraverso la costruzione di 
un albero. Al termine del processo si dovrà sempli- 
cemente esplorare l'albero a partire dalle foglie 
per avere l'insieme dei dati ordinato. Per capire as- 
sociamo la costruzione ad un esempio. Questa 
volta consideriamo come chiavi delle stringhe. Ec- 
co una sequenza che può servire allo scopo. Tarta- 
ruga, gatto, maiale, cane, topo, gallo, serpente. 
L'albero che si costruisce è rappresentato in 
Figura 1 . 
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Fig. 1: Albero corrispondente all'esecuzione di radix sort su un insieme di stringhe 

Il secchio e contiene solo cane mentre il secchio g 
contiene a un altro secchio o che contiene le due 
voci gallo e gatto. Ottenere i dati ordinati, equivale 
a effettuare una visita dell'albero posticipato (co- 
me indicato in figura). Per terminare vediamo 
quale albero corrisponde alla sequenza numerica 
che abbiamo usato come esercizio. 




Fig. 2: Albero corrispondente alla esecuzione di radix sort su sequenza numerica 



CONCLUSIONI 

Le performance degli algoritmi esaminati sono 
talmente formidabili che non richiedono ulteriori 
commenti. Sulle precondizioni, invece, vorrei 
puntualizzare che dipendono molto dall'ambito 
dove l'ordinamento deve essere svolto. Per alcune 
tipologie di dati questi algoritmi non hanno anta- 
gonisti, sono semplicemente i migliori. Non a caso 
sono parte integrante di molti motori 3-D. 
Ambienti in cui la velocità è un vero elemento di- 
scriminante. In altri casi, invece, un'attenta analisi 
del programmatore (meglio dell'analista) deve po- 
rtare ad optare per l'applicazione di altri metodi. 
Vi aspetto per il prossimo appuntamento per trat- 
tare ancora lo sconfinato mondo del sorting. 

Fabio Grimaldi 
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